Amazon Neptune 中的查詢計畫快取 - Amazon Neptune
如何強制啟用或停用查詢計劃快取如何判斷計劃是否快取移出導致計劃無法快取的條件

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon Neptune 中的查詢計畫快取

將查詢提交至 Neptune 時，查詢字串會剖析、最佳化並轉換為查詢計劃，然後由引擎執行。應用程式通常由以不同值執行個體化的常見查詢模式提供支援。查詢計畫快取可以透過快取查詢計畫來減少整體延遲，從而避免剖析和最佳化這類重複模式。

查詢計畫快取可用於 OpenCypher 查詢，包括非參數化或參數化查詢。它針對 READ 和 HTTP 和 Bolt 啟用。OC 變動查詢不支援此功能。Gremlin 或 SPARQL 查詢不支援此功能。

如何強制啟用或停用查詢計劃快取

低延遲參數化查詢預設會啟用查詢計畫快取。只有在延遲低於 100 毫秒閾值時，才會快取參數化查詢的計劃。查詢層級查詢提示 可以根據每個查詢 （無論是否參數化） 覆寫此行為QUERY:PLANCACHE。它需要與 USING子句搭配使用。查詢提示接受 enabled或 disabled作為值。

# Forcing plan to be cached or reused
% curl -k https://<endpoint>:<port>/opencypher \
  -d "query=Using QUERY:PLANCACHE \"enabled\" MATCH(n) RETURN n LIMIT 1"
  
% curl -k https://<endpoint>:<port>/opencypher \
  -d "query=Using QUERY:PLANCACHE \"enabled\" RETURN \$arg" \
  -d "parameters={\"arg\": 123}"
  
# Forcing plan to be neither cached nor reused
% curl -k https://<endpoint>:<port>/opencypher \
  -d "query=Using QUERY:PLANCACHE \"disabled\" MATCH(n) RETURN n LIMIT 1"

如何判斷計劃是否快取

對於 HTTP READ，如果已提交查詢且計劃已快取，則 explain會顯示與查詢計劃快取相關的詳細資訊。

% curl -k https://<endpoint>:<port>/opencypher \
  -d "query=Using QUERY:PLANCACHE \"enabled\" MATCH(n) RETURN n LIMIT 1" \
  -d "explain=[static|details]"

Query: <QUERY STRING>
Plan cached by request: <REQUEST ID OF FIRST TIME EXECUTION>
Plan cached at: <TIMESTAMP OF FIRST TIME EXECUTION>
Parameters: <PARAMETERS, IF QUERY IS PARAMETERIZED QUERY>
Plan cache hits: <NUMBER OF CACHE HITS FOR CACHED PLAN>
First query evaluation time: <LATENCY OF FIRST TIME EXECUTION>

The query has been executed based on a cached query plan. Detailed explain with operator runtime statistics can be obtained by running the query with plan cache disabled (using HTTP parameter planCache=disabled).

使用 Bolt 時，不支援解釋功能。

移出

快取存留時間 (TTL) 或已達到快取查詢計劃的最大數量時，會移出查詢計劃。當查詢計畫命中時，TTL 會重新整理。預設值為：

  • 1000 - 每個執行個體可快取的計劃數量上限。

  • TTL - 300，000 毫秒或 5 分鐘。快取命中會重新啟動 TTL，並將其重設回 5 分鐘。

導致計劃無法快取的條件

在下列情況下，不會使用查詢計劃快取：

  1. 使用查詢提示 提交查詢時QUERY:PLANCACHE "disabled"。您可以重新執行查詢並移除 QUERY:PLANCACHE "disabled"，以啟用查詢計劃快取。

  2. 如果提交的查詢不是參數化查詢，且不包含提示 QUERY:PLANCACHE "enabled"。

  3. 如果查詢評估時間大於延遲閾值，則不會快取查詢，且會被視為長時間執行的查詢，而不會受益於查詢計劃快取。

  4. 如果查詢包含未傳回任何結果的模式。

    • 即指定標籤為零節點MATCH (n:nonexistentLabel) return n時。

    • 亦即，當沒有包含 的節點parameters={"param": "abcde"}時MATCH (n {name: $param}) return n，使用 name=abcde。

  5. 如果查詢參數是複合類型，例如 list或 map。

    curl -k https://<endpoint>:<port>/opencypher \
  -d "query=Using QUERY:PLANCACHE \"enabled\" RETURN \$arg" \
  -d "parameters={\"arg\": [1, 2, 3]}"

curl -k https://<endpoint>:<port>/opencypher \
  -d "query=Using QUERY:PLANCACHE \"enabled\" RETURN \$arg" \
  -d "parameters={\"arg\": {\"a\": 1}}"

  6. 如果查詢參數是尚未成為資料載入或資料插入操作一部分的字串。例如，如果 CREATE (n {name: "X"}) 執行以插入 "X"，則 RETURN "X" 會快取，而 RETURN "Y"不會快取，因為 "Y" 尚未插入且不存在於資料庫中。