Plan-Cache in Amazon Neptune abfragen

Wenn eine Abfrage an Neptune gesendet wird, wird die Abfragezeichenfolge analysiert, optimiert und in einen Abfrageplan umgewandelt, der dann von der Engine ausgeführt wird. Anwendungen basieren häufig auf gängigen Abfragemustern, die mit unterschiedlichen Werten instanziiert werden. Der Abfrageplan-Cache kann die Gesamtlatenz reduzieren, indem er die Abfragepläne zwischenspeichert und so das Parsen und Optimieren für solche wiederholten Muster vermeidet.

Der Abfrageplan-Cache kann für OpenCypherAbfragen verwendet werden — sowohl für nicht parametrisierte als auch für parametrisierte Abfragen. Er ist für, und für und Bolt READ aktiviert. HTTP Es wird für OC-Mutationsabfragen nicht unterstützt. Es wird nicht für Gremlin oder SPARQL Abfragen unterstützt.

Wie erzwingt man die Aktivierung oder Deaktivierung des Abfrageplan-Caches

Der Abfrageplan-Cache ist standardmäßig für parametrisierte Abfragen mit niedriger Latenz aktiviert. Ein Plan für eine parametrisierte Abfrage wird nur zwischengespeichert, wenn die Latenz unter dem Schwellenwert von 100 ms liegt. Dieses Verhalten kann pro Abfrage (parametrisiert oder nicht) durch den Abfragehinweis auf Abfrageebene außer Kraft gesetzt werden. QUERY:PLANCACHE Es muss zusammen mit der Klausel verwendet werden. USING Der Abfragehinweis akzeptiert enabled oder disabled als Wert.

# 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"

Wie kann man feststellen, ob ein Plan zwischengespeichert ist oder nicht

Denn HTTP READ wenn die Anfrage eingereicht und der Plan zwischengespeichert wurde, explain würden Details angezeigt, die für den Abfrageplan-Cache relevant sind.

% 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).

Bei Verwendung von Bolt wird die Erklärungsfunktion nicht unterstützt.

Räumung

Ein Abfrageplan wird aufgrund der Gültigkeitsdauer des Caches (TTL) oder wenn eine maximale Anzahl von zwischengespeicherten Abfrageplänen erreicht wurde, gelöscht. Wenn der Abfrageplan erreicht wird, wird er aktualisiert. TTL Die Standardwerte sind:

• 1000 — Die maximale Anzahl von Plänen, die pro Instanz zwischengespeichert werden können.

• TTL- 300.000 Millisekunden oder 5 Minuten. Der Cache-Treffer startet den neu und setzt TTL ihn auf 5 Minuten zurück.

Bedingungen, die dazu führen, dass der Plan nicht zwischengespeichert wurde

Der Abfrageplan-Cache würde unter den folgenden Bedingungen nicht verwendet werden:

1. Wenn eine Abfrage mithilfe des Abfragehinweises gesendet wirdQUERY:PLANCACHE "disabled". Sie können die Abfrage erneut ausführen und entfernen, QUERY:PLANCACHE "disabled" um den Abfrageplan-Cache zu aktivieren.

2. Wenn es sich bei der übermittelten Abfrage nicht um eine parametrisierte Abfrage handelt und sie den Hinweis nicht enthält. QUERY:PLANCACHE "enabled"

3. Wenn die Abfrageauswertungszeit den Latenzschwellenwert überschreitet, wird die Abfrage nicht zwischengespeichert und als Abfrage mit langer Laufzeit betrachtet, für die der Abfrageplan-Cache nicht von Vorteil wäre.

4. Wenn die Abfrage ein Muster enthält, das keine Ergebnisse zurückgibt.

   • dh MATCH (n:nonexistentLabel) return n wenn es keine Knoten mit dem angegebenen Label gibt.

   • d.h. MATCH (n {name: $param}) return n parameters={"param": "abcde"} wenn es keine Knoten gibt, die enthaltenname=abcde.

5. Wenn der Abfrageparameter ein zusammengesetzter Typ ist, z. B. a list oder map a.

   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. Wenn der Abfrageparameter eine Zeichenfolge ist, die nicht Teil eines Datenlade- oder Dateneinfügevorgangs war. Wird CREATE (n {name: "X"}) beispielsweise ausgeführt, um einzufügen"X", dann RETURN "X" wird es zwischengespeichert, RETURN "Y" würde aber nicht zwischengespeichert werden, da es nicht eingefügt wurde und nicht in der Datenbank vorhanden "Y" ist.