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
-
Bietet eine große Erweiterung der Gremlin-Sprache.
-
Neue Schritte für die Verarbeitung von Zeichenketten, Listen und Daten.
-
Neue Syntax für die Angabe der Kardinalität innerhalb des Schritts.
mergeV()
-
union()
kann jetzt als Startschritt verwendet werden. -
Weitere Informationen zu den Änderungen in 3.7.x finden Sie in der TinkerPop Upgrade-Dokumentation
.
-
-
Beachten Sie beim Upgrade der Client-Gremlin-Sprachtreiber für Java, dass die Serializer-Klassen einige Umbenennungen rückgängig gemacht haben.
Sie müssen die Paket- und Klassennamen in Ihren Konfigurationsdateien und im Code, falls angegeben, aktualisieren.
-
-
StrictTimeoutValidation
(nur bei Aktivierung über LabmodeStrictTimeoutValidation
by includingStrictTimeoutValidation=enabled
): Wenn derStrictTimeoutValidation
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 konnte
InternalFailureException
, 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 innerenWITH
Klausel verwendetlimit
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 fehlschlagen
Parameter 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