DL∕ T 890.403-2012 能量管理系統(tǒng)應(yīng)用程序接口（EMS-API） 第403部分：通 用數(shù)據(jù)訪問(wèn)

備案號(hào)：37354-2012第403部分：通用數(shù)據(jù)訪問(wèn)2012-08-23發(fā)布2012-12-01實(shí)施國(guó)家能源局發(fā)布I Ⅱ Ⅲ1范圍 1 23術(shù)語(yǔ)和定義 24背景 25GDA讀訪問(wèn) 36GDA更新 附錄A(資料性附錄)GDA代理的使用 附錄B(資料性附錄)GDA開(kāi)發(fā)者實(shí)現(xiàn)導(dǎo)則 21參考文獻(xiàn) DL/T890.403—2012/IEC619用程序接口(EMS-API)》系列國(guó)際標(biāo)準(zhǔn)制定的，主要包括公共信息模型(CIM)和組件接口規(guī)范本部分等同采用IEC61970-403:2008《能量管理系統(tǒng)應(yīng)用程序接口(EMS-API)第403部分：DL/T890.403—2012/IEC6和DL890.5××包含組件接口規(guī)范(CIS)。DL890.4××CIS被規(guī)定為平臺(tái)無(wú)關(guān)模型(Platform組件(應(yīng)用或數(shù)據(jù)庫(kù))或系統(tǒng)維護(hù)的數(shù)據(jù)，而無(wú)須了解內(nèi)部存儲(chǔ)這些數(shù)DL/T890.403—2012/IEC619第403部分：通用數(shù)據(jù)訪問(wèn)在假設(shè)使用CIM的條件下，GDA可歸類為專門應(yīng)用于電力工業(yè)的企業(yè)信息集成(enterprise2DL/T890.403—2012/IEC619DL/T890.1能量管理系統(tǒng)應(yīng)用程序接口(EMS-API)第1部分：導(dǎo)則和一般要求(DL/TDL/Z890.2能量管理系統(tǒng)應(yīng)用程序接口(EMS-API)第2部分：術(shù)語(yǔ)(DL/Z890.2—2010,IEC(DL/Z890.401—2006,IEC61970-401服務(wù)(DL/T890.402—2012,IEC6197DL/T890.404能量管理系統(tǒng)應(yīng)用程序接口(EMS-API)第404部分：高速數(shù)據(jù)訪問(wèn)(HSDA)(DL/T890.404—2009,IEC61970-404:2007,IDT)DL/T890.405能量管理系統(tǒng)應(yīng)用程序接口(EMS-API)第405部分：通用事件和訂閱(GES)(DL/T890.405—2009,IEC61970-405:2DL/T890.407能量管理系統(tǒng)應(yīng)用程序接口(EMS-API)第407部分：時(shí)間序列數(shù)據(jù)訪問(wèn)(TSDA)(DL/T890.407—2010,IEC61970一些接口，使組件(或應(yīng)用)能夠通過(guò)標(biāo)準(zhǔn)的方式與其他組件(或應(yīng)用)交換信息和/或訪問(wèn)公共已有業(yè)標(biāo)準(zhǔn)，其中特別重要的部分是由OPC(最初OLE用于過(guò)程控制)和OMG(對(duì)象管理組織)開(kāi)發(fā)3DL/T890.402部分提供一些必要的和公共的基本功能，無(wú)論是通過(guò)引用納入的標(biāo)準(zhǔn)還是在本部分至DL890.449的通用接口標(biāo)準(zhǔn)所規(guī)定的新應(yīng)用程序接口都沒(méi)有提供這些基本功能。應(yīng)用可以結(jié)這些公共服務(wù)和通用接口。這些通用的獨(dú)立于應(yīng)用類別的接口包括本文件以及以下三個(gè)文件：高速數(shù)據(jù)訪問(wèn)(HSDA)通用事件和訂閱(GES)時(shí)間序列數(shù)據(jù)訪問(wèn)(TSDA)本部分定義了訪問(wèn)電力系統(tǒng)領(lǐng)域公共實(shí)體對(duì)象所需要的一些服務(wù)，這些實(shí)體對(duì)象在DL890.3××系列中定義。GDA允許客戶端訪問(wèn)由另一個(gè)組件(應(yīng)用或數(shù)據(jù)庫(kù))或系統(tǒng)維護(hù)的數(shù)據(jù)，而無(wú)須了解內(nèi)部存儲(chǔ)這些數(shù)據(jù)所用的邏輯模式，僅需知道存在這個(gè)公共模型即可managementsystem,uMS)數(shù)據(jù)訪問(wèn)設(shè)施(dataaccessfaclty,DAF)》為客戶端提供了查詢實(shí)例數(shù)據(jù)和元數(shù)據(jù)的基本功能。第二種是對(duì)公用事業(yè)管理系統(tǒng)數(shù)據(jù)訪問(wèn)設(shè)施的擴(kuò)展，為客戶端提供了一種更需GDA讀訪間的需求是要解決以只置的方式從個(gè)運(yùn)行的數(shù)據(jù)存儲(chǔ)中獲取數(shù)據(jù)的問(wèn)題。這些數(shù)據(jù)包括描述該系統(tǒng)的實(shí)際或仿真狀態(tài)的信息以及系統(tǒng)的模型數(shù)據(jù)。對(duì)于以準(zhǔn)實(shí)時(shí)或非實(shí)時(shí)方式集成多個(gè)應(yīng)用和系統(tǒng)來(lái)說(shuō)，DA讀訪問(wèn)應(yīng)該是足夠的。a)接口應(yīng)是義一個(gè)適用于訪問(wèn)電力系統(tǒng)運(yùn)行數(shù)據(jù)的標(biāo)準(zhǔn)方式。b)接口應(yīng)支抒在單一的CIM上下文中瀏覽和訪問(wèn)的實(shí)例數(shù)據(jù)和元數(shù)據(jù)，這些數(shù)據(jù)來(lái)自：2)需要以準(zhǔn)實(shí)時(shí)或非實(shí)時(shí)方式從GDA讀訪間提供者獲取輸入的外部系統(tǒng)，例如其他控制系c)接口應(yīng)提供以其雜模式(特別是用CIM)組織的數(shù)據(jù)的訪問(wèn)，這些數(shù)據(jù)包括：1)多個(gè)數(shù)據(jù)類模型可以包含成百上千個(gè)類；2)多種基本類型的類屬性，包括布爾型、整型、浮點(diǎn)型、字符申型和時(shí)間類型；3)引用關(guān)系，以是單值的或多值的；4)繼承關(guān)系。d)接口應(yīng)提供一個(gè)有效的方法用于獲得和連接大量的相關(guān)數(shù)據(jù)，例如多個(gè)實(shí)例的指定屬性值。e)接口不應(yīng)限定使用查詢。在更為廣泛的系統(tǒng)中應(yīng)盡可能實(shí)現(xiàn)這種功能，因?yàn)榇蠖鄶?shù)系統(tǒng)并不支持使用標(biāo)準(zhǔn)的查詢語(yǔ)言獲得它們的實(shí)時(shí)數(shù)據(jù)。也就是說(shuō)，GDA提供者不必提供查詢模式的方法就可以提供一個(gè)有意義的實(shí)現(xiàn)。例如，事先了解并在API中直接使用CIM數(shù)據(jù)模型及術(shù)f)接口應(yīng)支持讀事務(wù)。當(dāng)讀事務(wù)用于一系列數(shù)據(jù)訪問(wèn)操作時(shí)，所獲得的數(shù)據(jù)是前后一致的，且g)接口應(yīng)采用一種能夠適應(yīng)CIM未來(lái)變化的映射形式。這種映射應(yīng)該定義如何將CIM中的類、屬性以及關(guān)聯(lián)對(duì)應(yīng)所建議的接口中的結(jié)構(gòu)h)接口應(yīng)提供查詢和連接規(guī)格化與非規(guī)格化CIM數(shù)據(jù)的手段。即它應(yīng)該可以從由非規(guī)格化CIM數(shù)據(jù)視圖組成的結(jié)構(gòu)或使用模式中獲取CIM數(shù)據(jù)。4i)接口應(yīng)以與編程語(yǔ)言無(wú)關(guān)的方式定義GDA。j)GDA不應(yīng)包括任何不能提供獨(dú)立實(shí)現(xiàn)的服務(wù)。k)必須能用相同的方法通過(guò)標(biāo)準(zhǔn)映射來(lái)訪問(wèn)CIM數(shù)據(jù)而無(wú)需考慮底層CIM實(shí)現(xiàn)。1)接口應(yīng)簡(jiǎn)單并易于實(shí)現(xiàn)，從而促進(jìn)標(biāo)準(zhǔn)化并激勵(lì)供應(yīng)商及集成商去實(shí)現(xiàn)它。《公用事業(yè)管理系統(tǒng)數(shù)據(jù)訪問(wèn)設(shè)施》已經(jīng)充分涵蓋了與基本的讀訪問(wèn)需求有關(guān)的結(jié)構(gòu)和接口語(yǔ)義，本部分的讀訪問(wèn)部分引用了這一標(biāo)準(zhǔn)。此外，本部分文檔以標(biāo)準(zhǔn)引用的方式包括了《公用事業(yè)管理系統(tǒng)數(shù)據(jù)訪問(wèn)設(shè)施》資源查詢接口中包含的UML。GDA資源查詢模塊利用在DAF資源標(biāo)識(shí)和資源描述模塊定義的一組類來(lái)關(guān)聯(lián)和標(biāo)識(shí)各個(gè)類、類DAF資源查詢模塊提供的UML如圖1所示。0(fromDAFDescript△業(yè)(fromDAFDescriptResourceDescriptionite資源描述由資源查詢服務(wù)的操作得到。資源查詢服務(wù)接口提供三個(gè)基本操作和一個(gè)易于使用的高資源查詢服務(wù)接口中的每個(gè)操作都執(zhí)行一個(gè)單一查詢。查詢所返回的每一個(gè)資源描述包含所查詢屬性子集的值。返回的屬性值排列的順序和傳送給該查詢的屬性的順序相同，雖然其中一些屬性會(huì)被省略。如果對(duì)于一個(gè)特定的資源，某個(gè)屬性值無(wú)法從數(shù)據(jù)提供者得到，或者該屬性標(biāo)識(shí)符沒(méi)有被識(shí)別，則該屬性值被忽略。這一特性使得多個(gè)查詢服務(wù)可以聯(lián)合成一個(gè)查詢，其中每一個(gè)查詢服務(wù)回答5ResourceDescriptiongetResourceDescriptionget_extentproperties,AssoiciationassoResourceDescriptionget_dproperties,AssoiciationSeqResouceIDSequencesou得到零個(gè)或多個(gè)結(jié)果資源。對(duì)每一個(gè)結(jié)果資源，數(shù)據(jù)提供者獲取其給定的6DL/T890.403—201211酸get_filtered_descenV7這種邏輯與/或過(guò)濾器都是一個(gè)過(guò)濾節(jié)點(diǎn)三元組。表2給出了GDA過(guò)濾查詢?cè)亍BC3圖3一過(guò)濾解析樹示例述ropertyFilterNode,還是yalueFilterNoderopertyFilterNode,還是yalueFilterNode過(guò)濾節(jié)點(diǎn)類型(FilterfodeType)指明過(guò)濾節(jié)點(diǎn)是值用于表示該過(guò)濾節(jié)點(diǎn)是空的用于表示該過(guò)濾節(jié)點(diǎn)是操作過(guò)濾節(jié)點(diǎn)用于表示該過(guò)濾節(jié)點(diǎn)是屬性過(guò)濾節(jié)點(diǎn)用于表示該過(guò)濾節(jié)點(diǎn)是值過(guò)濾節(jié)點(diǎn)操作符8DL/T890.403—2012在一個(gè)值過(guò)濾節(jié)點(diǎn)的常數(shù)相比較的，還表示過(guò)濾節(jié)點(diǎn)三元組是如何邏輯與/或在值用于將多個(gè)過(guò)濾節(jié)點(diǎn)三元組進(jìn)行邏輯與操作用于將多個(gè)過(guò)濾節(jié)點(diǎn)三元組進(jìn)行邏輯或操作過(guò)濾節(jié)點(diǎn)的一個(gè)序列屬性過(guò)濾節(jié)點(diǎn)(PropertyFilterNode)用于指定被比較的屬性。表6給出了GDA過(guò)濾查詢值過(guò)濾節(jié)點(diǎn)(ValueFilterNode)用于包含與屬性進(jìn)行比較的值。表7給出了GDA過(guò)濾查詢9出QueryError異常。表8描述了GDA過(guò)濾查詢操作。ResourceDescriptionget_filtered_extent_UnknownResource,QueryEResourceDescriptionget_filtered_related_UnknownResourceQueryEget_filtered_descendResourceDescriptionget_filtered_decendent_path,ResourceIDSequencesources,FiltUnknownResource,QueryEget_filtered_related_values()查詢獲取與某父資源相關(guān)聯(lián)的所有資源的描述。父資源用一個(gè)DL/T890.403—2012/IEC6在某些情況下異常會(huì)被拋出。如果父資源標(biāo)識(shí)符對(duì)數(shù)據(jù)提供者來(lái)說(shuō)是無(wú)法識(shí)別的，則拋出ExtendedResourceQueryExtendedResourceQueryaassoc:AssociationDL/T890.403—2012/IEC61970-403:2008BreakerDeploymientBreakerDeploymient于建模一個(gè)示例GES消息。此字段定義在各種CIM類中，集合在此消息中用于滿足業(yè)務(wù)流程特死m(xù)eDteToDeployNam當(dāng)把類連接在一起時(shí)可以很容易地將被連接的類想象為一串左”租“右”類。借助圖5所舉連接類型(JoinType)關(guān)聯(lián)連接節(jié)點(diǎn)(AssociationJoinNode)規(guī)定了連接的類和關(guān)聯(lián)。表11描述了GDA過(guò)濾查詢連接DL/T890.403—2012/IEC61970-403:2008Ex:(ClassA.Property_a=ClassB.Property_b)andClassB.AssoC_To屬性列表屬性列表屬性屬性可選元素，包含一個(gè)關(guān)聯(lián)連接(AssociationJoin)可選元素，包含一個(gè)屬性連接(PropertyJoin)如果設(shè)置，則要求輸出一個(gè)外連接，即要返回“左”表10GDA過(guò)濾查詢連接類型用于指出該連接節(jié)點(diǎn)是關(guān)聯(lián)連接節(jié)點(diǎn)用于指出該連接節(jié)點(diǎn)是屬性連接節(jié)點(diǎn)DL/T890.403—2012/IECResourceDescriptionSequenceiUnknownAssociation,QueryEDL/T890.403—2012/IEC6GDA更新模塊需要提供對(duì)在GDA服務(wù)器中維護(hù)的元數(shù)據(jù)和實(shí)例數(shù)據(jù)的有限的(寫)訪問(wèn)。a)對(duì)象更新：從公共服務(wù)(commonservice)的觀點(diǎn)看，就是更新現(xiàn)有資源的屬性值的能力。b)多對(duì)象更新：提供在一個(gè)操作中更新一組對(duì)象的能力。c)對(duì)象生命周期的控制：提供創(chuàng)建及銷毀通過(guò)GDA訪問(wèn)的對(duì)象的能力。從公共服務(wù)的觀點(diǎn)看，就是創(chuàng)建和刪除資源的能力。這也意昧著具備建立和撤銷統(tǒng)一資源標(biāo)識(shí)符(uniformresourced)元數(shù)據(jù)的更新：創(chuàng)建。刪除和更新數(shù)據(jù)定義。從公共服務(wù)的觀點(diǎn)看，是指創(chuàng)建、刪除及更新e)封裝現(xiàn)有系統(tǒng)：O必須能夠?yàn)槎喾N系統(tǒng)(包括私有數(shù)據(jù)庫(kù)和現(xiàn)有能量管理系統(tǒng))實(shí)現(xiàn)接口。f)多客戶端、多提供者及并發(fā)：必須滿足多個(gè)客戶端和多個(gè)數(shù)據(jù)提供者之間的交互需求。當(dāng)考慮更新時(shí)需求被解釋為必須具備某種形式的并發(fā)控制。GDA寫訪問(wèn)?？焓前凑?.2所述需求設(shè)計(jì)的，特別是針對(duì)因此出現(xiàn)的更新并發(fā)和更新約束問(wèn)題。目前使用的多運(yùn)行系統(tǒng)所基于的持久化數(shù)據(jù)存儲(chǔ)并不支持事務(wù)處理，使得基于ACID?)事務(wù)處理的接口設(shè)計(jì)不能在這些系統(tǒng)上正確地實(shí)現(xiàn)。而且，許多這樣的系統(tǒng)僅提供粗粒度的鎖定機(jī)制，該機(jī)制運(yùn)行在整個(gè)數(shù)據(jù)庫(kù)表或物理分區(qū)上。在客戶端執(zhí)行這類鎖是機(jī)制會(huì)犧牲服務(wù)性能，在有多個(gè)客戶端本部分依賴一系列的預(yù)處理去檢測(cè)并發(fā)沖突。與一些優(yōu)化的鎖定策略相似，這種解決方案是可伸縮的并易于實(shí)現(xiàn)。個(gè)更新操作都帶有預(yù)處理信息，服務(wù)器用這些信息來(lái)檢測(cè)相直沖突的并發(fā)更新。預(yù)處理信息描述了客戶端在形成更新時(shí)對(duì)數(shù)據(jù)的假設(shè)。如果這些假設(shè)在服務(wù)器應(yīng)用該更新時(shí)成立，就表示沒(méi)有插入有沖突的更新，相反地，如果這些假設(shè)不再成立，那么該更新必須被拒絕。這相當(dāng)于一個(gè)鎖沖突，即由客戶端控制這個(gè)伴隨更新而生的預(yù)處理的范圍，等同于鎖閉方案中的讀—鎖范圍。預(yù)處理數(shù)據(jù)的粒度是屬性級(jí)的，與鎖的粒度是等同的。當(dāng)執(zhí)行一個(gè)更新操作時(shí)，要求數(shù)據(jù)提供者在短時(shí)間內(nèi)屏蔽其他更新來(lái)源。但是、這段時(shí)間比客戶端形成此更新所花費(fèi)的時(shí)間要少得多，而且不包括任何網(wǎng)絡(luò)延遲。數(shù)據(jù)提供者不必在多個(gè)更新操作之間替客戶端維護(hù)鎖狀態(tài)信息。不需要中止被丟標(biāo)準(zhǔn)的數(shù)據(jù)庫(kù)操作有插入、更新和刪除。如果想對(duì)數(shù)據(jù)庫(kù)有效地應(yīng)用這些操作，客戶端就需要了解比模式中所表示的約束更多的更新約束。這與讀訪問(wèn)形成了鮮明的對(duì)比，在讀訪問(wèn)中模式是充分的。更新約束由多個(gè)與實(shí)現(xiàn)有關(guān)的原因引發(fā)。下面的例子主要應(yīng)用于企業(yè)級(jí)的關(guān)系數(shù)據(jù)庫(kù)系統(tǒng)(在控制數(shù)據(jù)提供者中使用的私有數(shù)據(jù)庫(kù)系統(tǒng)可能會(huì)序操作(例如全都插入再更新，再刪除)規(guī)則。向差異)和要被刪除的信息(后向差異),而不是所請(qǐng)求的操作和它們的順異。一個(gè)差異模型由四組聲明構(gòu)成，每一組聲明編碼成一個(gè)資源描述(ResourceDescription)結(jié)構(gòu)序理的文檔里維護(hù)時(shí)，就利用這個(gè)成員。(關(guān)于在GDA服務(wù)器里使用文檔的更多信息，請(qǐng)查閱DL/T前向差異(forwardDiffere資源更新服務(wù)接口提供一些操作，用于更新通過(guò)GDA讀訪問(wèn)可以訪問(wèn)到的數(shù)據(jù)。表14描操作說(shuō)明示例ResourceIDSequenceapply_過(guò)ResourceIDService獲得的。rdf:type屬性可以通過(guò)把這一信息加到差異模型的Qaffected:ResourccI操作說(shuō)明示例DL/T890.403—2012 包含服務(wù)器啟動(dòng)的日期/時(shí)間包含開(kāi)發(fā)商的專用信息描述在8.2.4中服務(wù)器的能力DL/T890.403—2012/IEC61970-403:20088.2.3服務(wù)器狀態(tài)(ServerState)值8.2.4服務(wù)器能力(ServerCapab單一屬性。表18所示為ServerCa值服務(wù)器支持GDA資源查詢接口服務(wù)器支持GDA過(guò)濾查詢接口服務(wù)器支持GDA擴(kuò)展查詢接口服務(wù)器支持GDA更新接口服務(wù)器支持GDA事件接口服務(wù)器支持?jǐn)U展資源ID接口操作說(shuō)明示例(資料性附錄)GDA開(kāi)發(fā)者實(shí)現(xiàn)導(dǎo)則本導(dǎo)則為開(kāi)發(fā)者提供如何使用GDA的一些示例性導(dǎo)則，僅起指導(dǎo)作用。本導(dǎo)則給出了GDA客戶端和提供者所使用的URI語(yǔ)法的一些建議。注意，和任何其他XML一樣，它們是區(qū)分大小寫的。此URI列表來(lái)自RDF模式規(guī)范：c)rdfs:subClassOfj)rdf:IDProperty的值(未實(shí)現(xiàn));Class、Property或一個(gè)實(shí)例的資源ID。此URI列表反映了公共用法：CIM屬性的名字。屬性名字的語(yǔ)法是ClassName.PropertyName,具有枚舉值的名字。枚舉值名字的語(yǔ)法是Domain.EnumValue,具有唯一B.2.3標(biāo)準(zhǔn)CIM模式擴(kuò)展URI此URI列表反映了公共用法：關(guān)聯(lián)Property(資源ID)的對(duì)側(cè)。Property的多重屬性。這個(gè)多重的值為：類所屬于的CIM包。當(dāng)為數(shù)據(jù)值時(shí)取代rdfs:range。DL/T890.403—2012/IEC61970-403:2008a)對(duì)于基木刑DAF服務(wù)器必須展示其cimclassName.value和/或cim:clasName.units,這里b)rdfs:label;1)如果此屬性是一個(gè)關(guān)聯(lián)，rdfs:range需要返回該關(guān)聯(lián)類的資源ID。2)如果此屬性是枚舉類型，rdfs:range應(yīng)該返回相應(yīng)定義域的資源ID。3)如果此屬性是基本數(shù)據(jù)類型，cims:dataType應(yīng)該返回相應(yīng)定義域的資源ID。B.3.4.2定義域類的屬性a)如果此屬性是值或單位，其屬性列表應(yīng)該包含cims:dataType、daf:URI、rdfs:label、B.3.4.3類的實(shí)例的屬性a)rdf:ID(此實(shí)例的資源ID);b)rdf:type(此類的資源ID);B.3.4.4繼承的屬性這還意味著屬性的rdfs:domain屬性是把該屬性和包含它的類聯(lián)系起來(lái)的關(guān)聯(lián)，即能用getrelated_B.4推薦功能需求非標(biāo)準(zhǔn)地為GDA提供者推薦以下的服務(wù)層次。B.4.1推薦最小功能需求a)get_resource1