本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
管理DFE要使用的 Neptune 統計資料
注意
Support openCypher 取決於 Neptune 中的DFE查詢引擎。
該DFE引擎首先在 Neptune 引擎版本 1.0.3.0 的實驗室模式下提供,從 Neptune 引擎版本 1.0.5.0 開始,它預設為啟用,但僅適用於查詢提示和支援。 openCypher
從 Neptune 引擎版本 1.1.1.0 開始,DFE引擎不再處於實驗室模式,現在可以使用執行個體資料庫參數群組中的neptune_dfe_query_engine執行個體參數來控制。
DFE引擎會在規劃查詢執行時,使用 Neptune 圖表中的資料相關資訊,進行有效的權衡。這項資訊採取統計資料的形式,其中包括所謂的特性集和述詞統計資料,可以引導查詢規劃。
從引擎版本 1.2.1.0 開始,您可以使用GetGraphSummaryAPI或端點從這些統計資料擷取有關圖表的摘要資訊。summary
當圖表中超過 10% 的資料發生變更,或最新DFE統計資料超過 10 天時,就會重新產生這些統計資料。不過,這些觸發條件日後可能會變更。
注意
統計資料產生會在 T3
和 T4g
執行個體上停用,因為它可能超過這些執行個體類型的記憶體容量。
您可以透過下列其中一個端點管理DFE統計資料的產生:
https://
(適用於SPARQL)。your-neptune-host
:port
/rdf/statisticshttps://
(對於小精靈和openCypher),及其替代版本:。your-neptune-host
:port
/propertygraph/statisticshttps://
your-neptune-host
:port
/pg/statistics
注意
從引擎 1.1.1.0 版開始,Gramlin 統計資料端點 (https://
) 已被棄用以支持 your-neptune-host
:port
/gremlin/statisticspropertygraph
或 pg
端點。基於回溯相容性仍支援它,但可能會在未來的版本中將其移除。
從引擎版本 1.2.1.0 開始,SPARQL統計端點 (https://
) 已被棄用以支持端點your-neptune-host
:port
/sparql/statisticsrdf
。基於回溯相容性仍支援它,但可能會在未來的版本中將其移除。
在下面的例子中,$STATISTICS_ENDPOINT
代表這些端點中的任何一個URLs。
注意
如果DFE統計資料端點位於讀取器執行個體上,則唯一可以處理的要求就是狀態要求。其他請求將由於 ReadOnlyViolationException
而失敗。
DFE統計資料產生的大小限制
目前,如果達到下列任一大小限制,DFE統計資料產生就會中止:
所產生的特性集數目不得超過 50,000 個。
所產生的述詞統計資料數目不得超過一百萬個。
這些限制可能會變更。
DFE統計資料的目前狀態
您可以使用下列curl
要求檢查DFE統計資料的目前狀態:
curl -G "$STATISTICS_ENDPOINT"
對狀態請求的回應包含下列欄位:
status
— 要求的HTTP傳回碼。如果請求成功,則傳回碼為200
。如需常見錯誤的清單,請參閱 常見錯誤。-
payload
:autoCompute
– (布林值) 指示是否啟用自動產生統計資料。active
— (布林值) 指出是否完全啟用DFE統計資料產生。statisticsId
– 報告目前統計資料產生執行的 ID。值-1
指示尚未產生任何統計資料。-
date
— 最近產生DFE統計資料的UTC時間,格式為 ISO 8601。注意
在引擎 1.2.1.0 版之前,這是以分鐘精確度表示,但從引擎 1.2.1.0 版開始,它是以毫秒精確度表示 (例如,
2023-01-24T00:47:43.319Z
)。 note
– 關於統計資料無效情況下問題的說明。-
signatureInfo
– 包含統計資料中所產生之特性集的相關資訊 (在引擎 1.2.1.0 版之前,此欄位已命名為summary
)。這些通常不能直接採取行動:signatureCount
– 所有特性集的簽章總數。instanceCount
– 特性集執行個體的總數。predicateCount
– 唯一述詞的總數。
未產生統計資料時,對狀態請求的回應如下所示:
{ "status" : "200 OK", "payload" : { "autoCompute" : true, "active" : false, "statisticsId" : -1 } }
如果DFE統計數據可用,則響應如下所示:
{ "status" : "200 OK", "payload" : { "autoCompute" : true, "active" : true, "statisticsId" : 1588893232718, "date" : "2020-05-07T23:13Z", "summary" : { "signatureCount" : 5, "instanceCount" : 1000, "predicateCount" : 20 } } }
如果產生DFE統計資料失敗,例如因為超出統計資料大小限制,回應如下所示:
{ "status" : "200 OK", "payload" : { "autoCompute" : true, "active" : false, "statisticsId" : 1588713528304, "date" : "2020-05-05T21:18Z", "note" : "Limit reached: Statistics are not available" } }
停用自動產生DFE統計資料
依預設,啟用時會啟DFE用自動產生DFE統計資料。
您可以停用自動產生,如下所示:
curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "disableAutoCompute" }'
如果請求成功,則HTTP響應代碼為200
,響應為:
{ "status" : "200 OK" }
您可以發出狀態請求並檢查回應中的 autoCompute
欄位是否設定為 false
,以確認已停用自動產生。
停用自動產生統計資料並不會終止進行中的統計資料計算。
如果您提出要求停用讀取器執行個體的自動產生功能,而非資料庫叢集的寫入器執行個體,則要求會失敗,HTTP傳回碼為 400,並輸出如下所示:
{ "detailedMessage" : "Writes are not permitted on a read replica instance", "code" : "ReadOnlyViolationException", "requestId":"8eb8d3e5-0996-4a1b-616a-74e0ec32d5f7" }
如需其他常見錯誤的清單,請參閱 常見錯誤。
重新啟用自動產生統計資料 DFE
依預設,當您啟用時,已啟DFE用自動產生DFE統計資料。如果您停用自動產生,您可以稍後重新啟用它,如下所示:
curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "enableAutoCompute" }'
如果請求成功,則HTTP響應代碼為200
,響應為:
{ "status" : "200 OK" }
您可以發出狀態請求並檢查回應中的 autoCompute
欄位是否設定為 true
,以確認已啟用自動產生。
手動觸發統計資料的DFE產生
您可以手動啟動DFE統計資料產生,如下所示:
curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "refresh" }'
如果要求成功,則輸出如下,HTTP傳回碼為 200:
{ "status" : "200 OK", "payload" : { "statisticsId" : 1588893232718 } }
輸出中的 statisticsId
是目前正在發生之統計資料產生執行的識別符。如果執行已在請求時已處理中,則請求會傳回該執行的 ID,而不是啟動新的 ID。一次僅能發生一個統計資料產生執行。
如果在產生DFE統計資料時發生容錯移轉,新的寫入器節點會挑選上次處理的檢查點,並從該處繼續執行統計資料。
使用StatsNumStatementsScanned
CloudWatch 測量結果監督統計資料運算
此StatsNumStatementsScanned
CloudWatch 測量結果會傳回伺服器啟動後針對統計資料運算而掃描的敘述句總數。它是在每個統計資料計算部分處更新。
每次觸發統計資料計算時,這個數字都會增加,並且當沒有計算發生時,它會保持不變。因此,查看隨時間變化的 StatsNumStatementsScanned
值圖,可以很清楚地了解統計資料計算何時發生以及有多快:
![StatsNumStatementsScanned 測量結果值圖表](images/StatsNumStatementsScanned-graph.png)
進行計算時,圖形的斜坡會向您顯示有多快 (斜坡越陡,統計資料的計算速度越快)。
如果圖形只是一條位於 0 的平直線,表示已啟用統計資料功能,但根本沒有計算任何統計資料。如果已停用統計資料功能,或者如果您使用的引擎版本不支援統計資料計算,則 StatsNumStatementsScanned
不存在。
如前所述,您可以使用統計資料停用統計資料運算API,但是將其關閉可能會導致統計資料不是最新的,進而導致產生DFE引擎的查詢計畫不良。
如需有使用 Amazon 監控 Neptune CloudWatch關如何使用的資訊,請參閱 CloudWatch。
搭配DFE統計資料端點使用 AWS Identity and Access Management (IAM) 驗證
您可以使用 awscurl
awscurl "$STATISTICS_ENDPOINT" \ --region
(your region)
\ --service neptune-db
或者,例如,您可以建立一個名為的JSON檔案,request.json
其中包含:
{ "mode" : "refresh" }
您可以接著手動啟動統計資料產生,如下所示:
awscurl "$STATISTICS_ENDPOINT" \ --region
(your region)
\ --service neptune-db \ -X POST -d @request.json
刪除DFE統計
您可以向統計資料端點發出HTTPDELETE要求,以刪除資料庫中的所有統計資料:
curl -X "DELETE" "$STATISTICS_ENDPOINT"
有效的HTTP傳回代碼為:
-
200
– 刪除成功。在此情況下,典型的回應如下所示:
{ "status" : "200 OK", "payload" : { "active" : false, "statisticsId" : -1 } }
-
204
– 沒有任何要刪除的統計資料。在此情況下,回應是空白的 (沒有回應)。
如果將刪除請求傳送至讀取器節點上的統計資料端點,則會擲回 ReadOnlyViolationException
。
DFE統計資料要求的常見錯誤碼
以下是當您對統計資料端點提出請求時可能發生的常見錯誤清單:
AccessDeniedException
– 傳回碼:400
。訊息:Missing Authentication Token
。BadRequestException
(對於小鬼和openCypher)-返回代碼:。400
訊息:Bad route: /pg/statistics
。BadRequestException
(針對RDF資料) — 傳回代碼:400
。訊息:Bad route: /rdf/statistics
。InvalidParameterException
– 傳回碼:400
。訊息:Statistics command parameter 'mode' has unsupported value '
。the invalid value
'MissingParameterException
– 傳回碼:400
。訊息:Content-type header not specified.
。ReadOnlyViolationException
– 傳回碼:400
。訊息:Writes are not permitted on a read replica instance
。
例如,如果您在未啟用DFE和統計資料時提出要求,您會得到如下所示的回應:
{ "code" : "BadRequestException", "requestId" : "b2b8f8ee-18f1-e164-49ea-836381a3e174", "detailedMessage" : "Bad route: /sparql/statistics" }