可設定耗用量擷取
「可設定耗用量擷取」是一組用量訂閱 (選擇性地與特定市場參與者相關) 的測量資料擷取。
這些擷取的組態選項包含:
-
市場參與者類型,以「服務點市場參與者」或「用量訂閱市場參與者」資料表與市場關係為基準
-
與市場參與者相關聯的用量訂閱類型 (通常是接收帳單決定因子的客戶資訊系統)
-
與用量訂閱相關聯之計量單位、使用時間及服務數量識別碼的唯一組合
-
用來識別與所擷取測量資料相關聯之用量訂閱、服務點及裝置的特定識別碼
-
日期與時間參數和擷取頻率
-
擷取檔案命名和壓縮選項
耗用量擷取會匯出至指定檔案位置的檔案,該位置可以是應用程式伺服器 (在內部部署實作中) 也可以是 Oracle Cloud Infrastructure Object Storage 位置。
「耗用量擷取」是透過「耗用量擷取要求」建立。請參閱業務使用者指南中的耗用量擷取要求。
本節描述這些耗用量擷取類型所需的組態。
耗用量擷取類型
耗用量擷取的組態是透過「耗用量擷取類型」定義。如需有關建立這些記錄的詳細資訊,請參閱管理使用者指南中的耗用量擷取類型。
可設定耗用量擷取類型應使用「將用量訂閱耗用量擷取至檔案」(D1-ExtractUSConsumptionToFile) 業務物件建立。請參考此業務物件的內嵌說明,以取得為耗用量擷取類型定義之參數的更多相關明細。
「將用量訂閱耗用量擷取至檔案」耗用量擷取類型會定義下列參數:
- 將擷取測量資料的市場參與者。您可以根據市場參與者類型 (服務點市場參與者或用量訂閱市場參與者) 和市場關係類型 (零售商、分銷商、供應商等) 以及特定市場參與者來定義市場參與者。備註:如果「市場參與者特定」設為「否」,則使用的市場參與者是以「用量訂閱」或其「用量訂閱類型」上的「用量接收方」為基準。
- 耗用量類型 (區間或定量)
- 一或多個用量訂閱類型與相關的唯一計量單位/使用時間/服務數量 ID 組合
- 要包含在用量訂閱、服務點、下階服務點 (如果適用) 及裝置之擷取檔案中的特定 ID 類型
- 執行參數,包含:
- 為此耗用量擷取類型擷取資料的截止日期與時間
- 要求類型。與耗用量要求搭配使用的要求類型應使用「耗用量擷取要求類型」(D2-IntervalDataExtRepoType) 業務物件建立,且應在要求業務物件欄位中參考「耗用量擷取」(D2-IntervalDataExtRepository) 業務物件。(請參閱 Application Framework 管理使用者指南中的要求概要)
- 此類型的擷取頻率 (特設或每日)
- 用於擷取處理的批次控制 (請參閱下方的批次控制)
- 檔案參數,包含:
- 將儲存擷取檔案的檔案位置 (請參閱 Application Framework 管理使用者指南中的外部檔案儲存)
- 檔案位置中的選擇性下階資料夾
- 檔案命名選項 (包含選擇性的前綴與日期/時間戳記)
- 是否壓縮擷取檔案 (使用 gzip 執行檔案壓縮)
批次控制
資料擷取處理與建立匯出檔案是由下列批次控制執行:
- 將目前用量訂閱區間擷取至檔案 (D1-ECUSI):用於區間耗用量的每日擷取。此處理需要為任何擷取的區間大小產生「區間快照對應」資料。這有助於提升將區間資料轉換為每日區間資料欄的效率。(如需詳細資訊,請參閱區間快照對應)。
- 將取代用量訂閱區間擷取至檔案 (D1-ERUSI):用於取代歷史區間耗用量的擷取。此處理會針對「一般處理」資料表中的「變更資料擷取」記錄執行 (請參閱下方的初始測量後續更正變更資料擷取)。
- 將目前用量訂閱定量抄表擷取至檔案 (D1-ECUSS):用於定量耗用量的每日擷取。
- 將取代用量訂閱定量抄表擷取至檔案 (D1-ERUSI):用於取代定量區間耗用量的擷取。此處理會針對「一般處理」資料表中的「變更資料擷取」記錄執行 (請參閱下方的初始測量後續更正變更資料擷取)。
這些批次控制會針對特定「耗用量擷取類型」與日期範圍執行。批次處理會依「用量訂閱 ID」進行執行緒處理。
如需有關耗用量擷取批次處理的一般資訊,請參考整合章節之定義 DataConnect 選項小節中的耗用量擷取要求 - 批次控制。
初始測量後續更正變更資料擷取
下列演算法會根據測量元件的最新測量日期時間來維護測量元件日期/時間。這些演算法也會檢查適用於目前初始測量之測量元件的「耗用量擷取類型」,並識別初始測量是否針對已擷取的日期/時間。
演算法 |
描述 |
耗用量類型 |
---|---|---|
D1-UPD-DTMC |
使用耗用量同步來更新測量元件上的最新測量日期/時間 |
區間 |
D1-UDTSCMCRE |
使用耗用量同步來更新定量測量元件上的最新測量日期/時間 |
定量 |
D1-UPD-DTMCF |
從未來測量更新測量元件上的最新日期/時間 |
區間 |
D1-UPDDTSCMC |
更新定量測量元件上的最新日期/時間 |
定量 |
如果初始測量是針對已擷取的日期/時間,這些演算法會在「一般處理」資料表中建立「變更資料擷取」記錄,以擷取批次代碼、批次執行編號及初始測量 ID。「取代」批次處理會根據這些記錄執行。
- 擷取 CET 歷史測量變更:真
資料擷取檔案格式 - 區間
區間擷取處理作業會產生含有下表所述擷取資料的 JavaScript Object Notation (JSON) 檔案。
請注意,區間擷取檔案最多可以儲存 300 個區間。這表示匯出檔案大約可以儲存:
- 12.5 天的每小時資料
- 3 天的 15 分鐘資料
- 1 天的 5 分鐘資料
欄位 |
範例值 |
註釋 |
---|---|---|
usId |
995647003500 |
由「耗用量擷取類型」定義的「用量訂閱 ID」 |
usType |
E-RES |
用量訂閱類型 |
pSpId |
458081 |
上階服務點 ID,沒有上階服務點時為 Null。 |
spId |
458081_001 |
下階服務點 ID 這是由「耗用量擷取類型」定義的「服務點 ID」 |
dvcId |
SN823287793219 |
由「耗用量擷取類型」定義的「裝置 ID」 |
uomTouSqi |
KWH// |
計量單位/使用時間/服務數量 ID,以正斜線 ("/") 分隔 |
tz |
美國/東部 |
服務點的時區。 這是 CI_TIME_ZONE 資料表中的時區名稱,而不是時區代碼。 |
intPerDay |
288 |
當日的區間數,日光節約時間轉變的區間將少 1 小時或多 1 小時 |
intSize |
300 |
每個區間的長度 (秒數) |
mktPart |
DIRECT_ENERGY |
市場參與者的市場參與者 ID (如果適用) |
stDttm |
2020-01-01T00:00:00-05:00 |
一天的開始 (與初始測量類似),這代表第一個區間的開始。 |
q1 |
1.325 |
第一個區間的測量值,此區間的測量日期/時間會是 stDttm 加上 intSize |
c1 |
301000 |
第一個區間的測量條件。 「正常」(501000) 時為 Null |
q2 |
1.230 |
|
c2 |
301000 |
|
... |
這裡是 q/c 3 到 299 |
|
q300 |
.9134 |
|
c300 |
30100 |
範例:
{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
"tz":"US/Eastern", "intPerDay":"288", "intSize":"300", "mktPart":"DIRECT_ENERGY",
"stDttm":"2020-01-01T00:00:00-05:00", "q1":"1.325", "c1":"301000", "q2":"1.325",
"c2":"301000" "q3":"1.325", "c3":"301000",
<intervening intervals>, "q300":"1.325", "c300":"301000"}
資料擷取檔案格式 - 定量
定量擷取處理作業會產生含有下表所述擷取資料的 JavaScript Object Notation (JSON) 檔案。
名稱 |
範例值 |
註釋 |
---|---|---|
c |
301000 |
定量抄表值的測量條件 「正常」(501000) 時為 Null |
dvcId |
SN823287793219 |
由「耗用量擷取類型」定義的「裝置 ID」 |
enDttm |
2020-01-02T00:00:00-05:00 |
抄表值的結束日期/時間 |
mktPart |
DIRECT_ENERGY |
市場參與者的市場參與者 ID (如果適用) |
pSpId |
458081 |
|
q |
1.325 |
定量抄表值的測量值 |
r |
678645 |
計量表的刻度盤抄表值 |
spId |
458081_001 |
由「耗用量擷取類型」定義的「服務點 ID」 |
stDttm |
2020-01-01T00:00:00-05:00 |
抄表值的開始日期/時間 (上次抄表值的結束日期/時間) |
tz |
美國/東部 |
服務點的時區。 這是 CI_TIME_ZONE 資料表中的時區名稱,而不是時區代碼。 |
uomTouSqi |
KWH// |
計量單位/使用時間/服務數量 ID,以正斜線 ("/") 分隔 |
usId |
995647003500 |
由「耗用量擷取類型」定義的「用量訂閱 ID」 |
usType |
E-RES |
用量訂閱類型 |
範例 (3 筆記錄):
{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
"tz":"US/Eastern", "mktPart":"DIRECT_ENERGY", "stDttm":"2020-01-01T00:00:00-05:00",
"enDttm":"2020-01-02T00:00:00-05:00", "q":"1.325", "c":"301000", "r":"678645"}
{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
"tz":"US/Eastern", "mktPart":"DIRECT_ENERGY", "stDttm":"2020-01-01T00:00:00-05:00",
"enDttm":"2020-01-02T00:00:00-05:00", "q":"1.325", "c":"301000", "r":"678645"}
{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
"tz":"US/Eastern", "mktPart":"DIRECT_ENERGY", "stDttm":"2020-01-01T00:00:00-05:00",
"enDttm":"2020-01-02T00:00:00-05:00", "q":"1.325", "c":"301000", "r":"678645"}
{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
"tz":"US/Eastern", "mktPart":"DIRECT_ENERGY", "stDttm":"2020-01-01T00:00:00-05:00",
"enDttm":"2020-01-02T00:00:00-05:00", "q":"1.325", "c":"301000", "r":"678645"}
延伸擷取處理
某些實作可能會希望根據特定需求延伸和 (或) 自訂擷取處理。
延伸要使用的 ID 列表
「耗用量擷取類型」會定義用於「用量訂閱」、「服務點」、「下階服務點」(如果適用) 及「裝置」的特定 ID 類型。如果實作想要延伸可用的 ID 類型,則必須將適當的值新增至每個 ID 類型所使用的查尋標誌。下表列出「要使用的 ID」欄位所使用的查尋代碼。
ID 類型 |
查尋標誌 |
---|---|
用量訂閱 ID |
用量訂閱識別碼類型 (US_ID_TYPE_FLG) |
服務點 ID (用於上階與下階服務點) |
服務點識別碼類型 (SP_ID_TYPE_FLG) |
裝置 ID |
裝置識別碼類型 (DVC_ID_TYPE_FLG) |
處理記錄與建立輸出檔案
擷取處理利用一般外掛導向的背景處理功能,但運作方式略有不同。該演算法不使用「選取記錄」演算法來擷取要處理之個別記錄的 ID,而是傳回要擷取之「用量訂閱 ID」的範圍,且「處理記錄」演算法會執行詳細查詢來擷取「用量訂閱 ID」的範圍。
這有兩個優點:
-
不會限制「處理記錄」演算法中的查詢長度。
-
顯著提升一次擷取多個用量訂閱之資料的效率。
這表示可以透過建立新的自訂 (CM) 批次控制並複製「處理記錄 Groovy」指令檔來實現任何必要的自訂。您可以在自訂 Groovy 指令碼內對擷取 SQL 進行變更,以擷取其他資訊或提供其他選取準則。如果檔案格式需要任何變更,可在植入檔案的記錄處理邏輯內完成。