Amazon Neptune Engine, Version 1.3.2.0 (10.06.2020) - Amazon Neptune

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon Neptune Engine, Version 1.3.2.0 (10.06.2020)

Ab 2024-06-10 wird die Engine-Version 1.3.2.0 allgemein bereitgestellt. Bitte beachten Sie, dass es mehrere Tage dauert, bis eine neue Version in jeder Region verfügbar ist.

Anmerkung

Mit der Engine-Version 1.3.0.0 wurde ein neues Format für benutzerdefinierte Parametergruppen und benutzerdefinierte Cluster-Parametergruppen eingeführt. Wenn Sie also von einer Engine-Version vor 1.3.0.0 auf Engine-Version 1.3.0.0 oder höher aktualisieren, müssen Sie alle vorhandenen benutzerdefinierten Parametergruppen und benutzerdefinierten Cluster-Parametergruppen mithilfe der Parametergruppenfamilie neptune1.3 neu erstellen. In früheren Versionen wurde die Parametergruppenfamilie neptune1 oder neptune1.2 verwendet. Diese Parametergruppen funktionieren nicht mit Version 1.3.0.0 und höher. Weitere Informationen finden Sie unter Amazon-Neptune-Parametergruppen.

Warnung

Mit der Engine-Version 1.3.2.0 wurden einige potenzielle Probleme eingeführt, die Sie beachten sollten. Weitere Informationen finden Sie im Behebung von Problemen in Version 1.3.2.0 folgenden Abschnitt.

Verbesserungen in dieser Engine-Version

Allgemeine Verbesserungen
  • Support für TLS Version 1.3, einschließlich Cipher Suites TLS _ AES _128_ _ SHA256 und TLS _ _256_ GCM _. AES GCM SHA384 TLS1.3 ist eine Option — TLS 1.2 ist immer noch das Minimum.

Gremlin-Verbesserungen
  • TinkerPop 3.7.x-Aktualisierung

  • StrictTimeoutValidation(nur bei Aktivierung über Labmode StrictTimeoutValidation by includingStrictTimeoutValidation=enabled): Wenn der StrictTimeoutValidation Parameter den Wert von hatenabled, darf ein als Anforderungsoption oder als Abfragehinweis spezifizierter Timeout-Wert pro Abfrage den global in der Parametergruppe festgelegten Wert nicht überschreiten. In einem solchen Fall wirft Neptune eine. InvalidParameterException Diese Einstellung kann in einer Antwort auf dem /status Endpunkt bestätigt werden, wenn der Wert lautetdisabled, und in Neptune Version 1.3.2.0 ist der Standardwert dieses Parameters. Disabled

openCypher Verbesserungen
  • Die Amazon Neptune Engine Version 1.3.2.0 bietet im Vergleich zu früheren Engine-Versionen eine bis zu 9-mal schnellere und 10-mal höhere openCypher Abfrageleistung.

  • Abfragen mit niedriger Latenz und Verbesserung der Durchsatzleistung: Allgemeine Leistungsverbesserungen für Abfragen mit niedriger Latenz. openCypher Die neue Version verbessert auch den Durchsatz für solche Abfragen. Die Verbesserungen sind signifikanter, wenn parametrisierte Abfragen verwendet werden.

  • Support für Query Plan Cache: 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 sich wiederholenden Muster vermeidet.

  • Leistungsverbesserung für DISTINCT Aggregationsabfragen.

  • Leistungsverbesserung für Verknüpfungen mit Variablen, bei denen NULL-Werte zulässig sind.

  • Leistungsverbesserung für Abfragen, bei denen das Prädikat „Nicht entspricht ID“ (Knoten/Beziehung) verwendet wird.

  • Erweiterte Unterstützung für die Datetime-Funktionalität (Nur im Labormodus aktiviert durch Including. DatetimeMillisecond DatetimeMillisecond=enabled Weitere Informationen finden Sie unter Temporale Unterstützung in der openCypher Neptune-Implementierung (Neptune Analytics und Neptune Database 1.3.2.0 und höher).

In dieser Engine-Version behobene Fehler

Allgemeine Verbesserungen
  • Die NeptuneML-Fehlermeldung bei der Validierung des Zugriffs auf Graphlytics-Buckets wurde aktualisiert.

Korrekturen für Gremlin
  • Fehlende Labelinformationen in der DFE Abfrageübersetzung für Szenarien behoben, in denen Schritte, die nicht zum Pfad beitragen, Beschriftungen enthalten. Beispielsweise:

    g.withSideEffect('Neptune#useDFE', true). V(). has('name', 'marko'). has("name", TextP.regex("mark.*")).as("p1"). not(out().has("name", P.within("peter"))). out().as('p2'). dedup('p1', 'p2')
  • Es wurde ein NullPointerException Fehler in der DFE Abfrageübersetzung behoben, der auftrat, wenn eine Abfrage in zwei DFE Fragmenten ausgeführt wurde und das erste Fragment für einen unbefriedigenden Knoten optimiert wurde. Beispielsweise:

    g.withSideEffect('Neptune#useDFE', true). V(). has('name', 'doesNotExists'). has("name", TextP.regex("mark.*")). inject(1). V(). out(). has('name', 'vadas')
  • Es wurde ein Fehler behoben, durch den Neptune einen auslösen konnteInternalFailureException, wenn eine Abfrage den Modulator ValueTraversal inside by () enthält und die Eingabe Map ist. Beispielsweise:

    g.V(). hasLabel("person"). project("age", "name").by("age").by("name"). order().by("age")
openCypher behebt
  • Verbesserte UNWIND Operationen (z. B. das Erweitern einer Werteliste auf einzelne Werte), um Situationen zu vermeiden, in denen nicht genügend Arbeitsspeicher (OOM) zur Verfügung steht. Beispielsweise:

    MATCH (n)-->(m) WITH collect(m) AS list UNWIND list AS m RETURN m, list
  • Die benutzerdefinierte ID-Optimierung bei mehreren MERGE Operationen, bei denen die ID über eingegeben wurde, wurde behobenUNWIND. Beispielsweise:

    UNWIND [{nid: 'nid1', mid: 'mid1'}, {nid: 'nid2', mid: 'mid2'}] as ids MERGE (n:N {`~id`: ids.nid}) MERGE (m:M {`~id`: ids.mid})
  • Die Speicherexplosion bei der Planung komplexer Abfragen mit Eigenschaftszugriff und mehreren Hops mit bidirektionalen Beziehungen wurde behoben. Beispielsweise:

    MATCH (person1:person)-[:likes]->(res)-[:partOf]->(group)-[:knows]-(:entity {name: 'foo'}), (person1)-[:knows]->(person2)-[:likes]-(res2), (comment)-[:presentIn]->(:Group {name: 'barGroup'}), (person1)-[:commented]->(comment2:comment)-[:partOf]->(post:Post), (comment2)-[:presentIn]->(:Group {name: 'fooGroup'}), (comment)-[:contains]->(info:Details)-[:CommentType]->(:CommentType {name: 'Positive'}), (comment2)-[:contains]->(info2:Details)-[:CommentType]->(:CommentType {name: 'Positive'}) WHERE datetime('2020-01-01T00:00') <= person1.addedAfter <= datetime('2023-01-01T23:59') AND comment.approvedBy = comment2.approvedBy MATCH (comment)-[:contains]->(info3:Details)-[:CommentType]->(:CommentType {name: 'Neutral'}) RETURN person1, group.name, info1.value, post.ranking, info3.value
  • Aggregationsabfragen mit Null als Gruppierung nach Variablen behoben. Beispielsweise:

    MATCH (n) RETURN null AS group, sum(n.num) AS result
SPARQLbehebt
  • Der SPARQL Parser wurde behoben, um die Analysezeit für große Abfragen zu verbessern, z. B. wenn sie viele Tripel und große Tokens INSERT DATA enthalten.

Behebung von Problemen in Version 1.3.2.0

  • Für Version 1.3.2.0 haben wir ein Problem im Abfrageplan-Cache festgestellt, wenn skip oder in einer inneren WITH Klausel verwendet limit wird und parametrisiert ist. Beispielsweise:

    MATCH (n:Person) WHERE n.age > $age WITH n skip $skip LIMIT $limit RETURN n.name, n.age parameters={"age": 21, "skip": 2, "limit": 3}

    In diesem Fall werden die Parameterwerte für Skip und Limit aus dem ersten Plan auch auf nachfolgende Abfragen angewendet, was zu unerwarteten Ergebnissen führt.

    Schadensbegrenzung

    Um dieses Problem zu vermeiden, fügen Sie den Abfragehinweis hinzu, QUERY:PLANCACHE "disabled" wenn Sie eine Abfrage einreichen, die eine parametrisierte Skip- und/oder Limit-Unterklausel enthält. Alternativ können Sie die Werte in der Abfrage fest codieren.

    Option 1: Verwenden des Abfragehinweises zum Deaktivieren des Plan-Caches:

    Using QUERY:PLANCACHE "disabled" MATCH (n:Person) WHERE n.age > $age WITH n skip $skip LIMIT $limit RETURN n.name, n.age parameters={"age": 21, "skip": 2, "limit": 3}

    Option 2: Verwendung hartcodierter Werte für Skip und Limit:

    MATCH (n:Person) WHERE n.age > $age WITH n skip 2 LIMIT 3 RETURN n.name, n.age parameters={"age": 21}
  • Abfragen, die numerische Filterwerte verwenden, können zu falschen Ergebnissen führen, wenn der Abfrageplan-Cache verwendet wird. Um das Problem zu vermeiden, verwenden Sie den Abfragehinweis, QUERY:PLANCACHE "disabled" um den Abfrageplan-Cache zu überspringen. Verwenden Sie beispielsweise:

    USING QUERY:PLANCACHE "disabled" MATCH (n:person) WHERE n.yearOfBirth > $year RETURN n parameters={"year":1950}
  • Abfragen, die denselben Parameternamen mehrfach verwenden, können mit dem Fehler fehlschlagenParameter name should not be a number and/or contain _internal_ or _modified_user_ string within it. These are reserved for planCache. Otherwise, rerun with HTTP parameter planCache=disabled. Überspringen Sie in solchen Fällen entweder den Abfrageplan-Cache wie oben oder duplizieren Sie die Parameter wie in diesem Beispiel:

    MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n UNION MATCH (n:show) WHERE n.duration>=$minutes RETURN n parameters={"minutes":130}

    Verwenden Sie den Hinweis QUERY:PLANCACHE "disabled" oder ändern Sie die Parameter:

    MATCH (n:movie) WHERE n.runtime>=$rt_min RETURN n UNION MATCH (n:show) WHERE n.duration>=$dur_min RETURN n parameters={"rt_min":130, "dur_min":130}
  • Abfragen, die mit dem Bolt-Protokoll ausgeführt werden, können zu falschen Ergebnissen führen, wenn es sich bei der Abfrage um eine UNION UNION ALL OR-Abfrage handelt. Um dieses Problem zu vermeiden, sollten Sie erwägen, die jeweilige Abfrage mit dem HTTP Endpunkt auszuführen. Alternativ können Sie jeden Teil der Union separat ausführen, wenn Sie das Bolt-Protokoll verwenden.

In dieser Version unterstützte Versionen in Abfragesprache

Bevor Sie einen DB-Cluster auf Version 1.3.2.0 aktualisieren, stellen Sie sicher, dass Ihr Projekt mit den folgenden Versionen in Abfragesprache kompatibel ist:

  • Die älteste unterstützte Version von Gremlin: 3.7.1

  • Die neueste unterstützte Version von Gremlin: 3.7.1

  • openCypher Version: Neptune-9.0.20190305-1.0

  • SPARQLAusführung: 1.1

Upgrade-Pfade auf Engine-Version 1.3.2.0

Sie können von der Engine-Version 1.2.0.0 oder höher auf diese Version aktualisieren.

Upgrade auf diesen Release

Wenn auf einem DB-Cluster eine Engine-Version ausgeführt wird, für die es einen Upgrade-Pfad zu dieser Version gibt, kann sie jetzt aktualisiert werden. Sie können jeden geeigneten Cluster mithilfe der DB-Cluster-Operationen auf der Konsole oder mithilfe von aktualisieren. SDK Mit dem folgenden CLI Befehl wird ein berechtigtes Cluster sofort aktualisiert:

Für Linux, OS X oder Unix:

aws neptune modify-db-cluster \ --db-cluster-identifier (your-neptune-cluster) \ --engine-version 1.3.2.0 \ --allow-major-version-upgrade \ --apply-immediately

Für Windows:

aws neptune modify-db-cluster ^ --db-cluster-identifier (your-neptune-cluster) ^ --engine-version 1.3.2.0 ^ --allow-major-version-upgrade ^ --apply-immediately

Statt --apply-immediately können Sie --no-apply-immediately angeben. Um ein Upgrade auf eine Hauptversion durchzuführen, ist der allow-major-version-upgrade Parameter erforderlich. Stellen Sie außerdem sicher, dass Sie die Engine-Version angeben, da Ihre Engine sonst möglicherweise auf eine andere Version aktualisiert wird.

Wenn Ihr Cluster eine benutzerdefinierte Cluster-Parametergruppe verwendet, müssen Sie diesen Parameter einschließen, um ihn zu anzugeben:

--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)

Ebenso sollte für Instances im Cluster, die eine benutzerdefinierte DB-Parametergruppe verwenden, dieser Parameter eingeschlossen werden, um ihn zu spezifizieren:

--db-instance-parameter-group-name (name of the custom instance parameter group)

Testen Sie immer vor dem Upgrade

Wenn eine neue Haupt- oder Nebenversion der Neptune-Engine veröffentlicht wird, testen Sie Ihre Neptune-Anwendungen immer zuerst dafür, bevor Sie sie dazu aktualisieren. Selbst ein Nebenversions-Upgrade könnte neue Features oder Verhaltensweisen einführen, die sich auf Ihren Code auswirken können.

Vergleichen Sie zunächst die Seiten mit den Versionshinweisen Ihrer aktuellen Version mit denen der Zielversion, um festzustellen, ob es Änderungen an den Versionen der Abfragesprache oder andere wichtige Änderungen geben wird.

Die beste Methode, eine neue Version zu testen, bevor Sie Ihren Produktions-DB-Cluster aktualisieren, besteht darin, den Produktions-Cluster zu klonen, so dass auf dem Klon die neue Engine-Version ausgeführt wird. Sie können dann Abfragen auf dem Klon ausführen, ohne dass der Produktions-DB-Cluster davon betroffen wird.

Erstellen Sie vor einem Upgrade immer einen manuellen Snapshot

Bevor Sie ein Upgrade durchführen, wird dringend empfohlen, immer einen manuellen Snapshot Ihres DB-Clusters zu erstellen. Ein automatischer Snapshot bietet nur kurzfristigen Schutz, wohingegen ein manueller Snapshot verfügbar bleibt, bis Sie ihn explizit löschen.

In bestimmten Fällen erstellt Neptune im Rahmen des Upgrade-Prozesses einen manuellen Snapshot für Sie, aber Sie sollten sich nicht darauf verlassen und in jedem Fall Ihren eigenen manuellen Snapshot erstellen.

Wenn Sie sicher sind, dass Sie Ihren DB-Cluster nicht auf den Zustand vor dem Upgrade zurücksetzen müssen, können Sie den manuellen Snapshot, den Sie selbst erstellt haben, sowie den manuellen Snapshot, den Neptune möglicherweise erstellt hat, explizit löschen. Wenn Neptune einen manuellen Snapshot erstellt, hat dieser einen Namen, der mit preupgrade beginnt, gefolgt vom Namen Ihres DB-Clusters, der Quell-Engine-Version, der Ziel-Engine-Version und dem Datum.

Anmerkung

Wenn Sie versuchen, ein Upgrade durchzuführen, während eine ausstehende Aktion ausgeführt wird, kann ein Fehler wie der folgende auftreten:

We're sorry, your request to modify DB cluster (cluster identifier) has failed. Cannot modify engine version because instance (instance identifier) is running on an old configuration. Apply any pending maintenance actions on the instance before proceeding with the upgrade.

Wenn dieser Fehler auftritt, warten Sie, bis die ausstehende Aktion abgeschlossen ist, oder starten Sie sofort ein Wartungsfenster, damit das vorherige Upgrade abgeschlossen werden kann.

Weitere Informationen zum Upgraden Ihrer Engine-Version finden Sie unter Warten eines Amazon-Neptune-DB-Clusters. Wenn Sie Fragen oder Bedenken haben, steht Ihnen das AWS Support-Team in den Community-Foren und über den AWS Premium-Support zur Verfügung.