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

Wir haben ein Problem im Abfrageplan-Cache festgestellt, wenn skip oder in einer inneren Klausel verwendet limit wird und parametrisiert ist. WITH 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. Weitere Informationen finden Sie unter Behebung des Cache-Problems mit dem Abfrageplan.

Verbesserungen in dieser Engine-Version

Allgemeine Verbesserungen

• Support für TLS Version 1.3, einschließlich der Verschlüsselungssammlungen TLS_AES_128_GCM_SHA256 und TLS_AES_256_GCM_SHA384. TLS 1.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 Labmode StrictTimeoutValidation by includeStrictTimeoutValidation=enabled): Wenn der StrictTimeoutValidation Parameter den Wert 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

Verbesserungen bei OpenCypher

• Abfragen mit niedriger Latenz und Verbesserung der Durchsatzleistung: Allgemeine Leistungsverbesserungen für OpenCypher-Abfragen mit niedriger Latenz. 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 NULL-Variablen.

• Leistungsverbesserung bei 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 Neptune OpenCypher-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 bei der Übersetzung von DFE-Abfragen behoben, der auftritt, wenn eine Abfrage in zwei DFE-Fragmenten ausgeführt wird 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-Korrekturen

• Verbesserte UNWIND-Operationen (z. B. das Erweitern einer Werteliste auf einzelne Werte), um Situationen zu vermeiden, in denen der Arbeitsspeicher knapp wird (OOM). 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 UNWIND eingegeben wurde, wurde behoben. Beispielsweise:

  UNWIND [{nid: 'nid1', mid: 'mid1'}, {nid: 'nid2', mid: 'mid2'}] as ids
  MERGE (n:N {`~id`: ids.nid})
  MERGE (m:M {`~id`: ids.mid})

• Speicherexplosion bei der Planung komplexer Abfragen mit Eigenschaftszugriff und mehreren Hops mit bidirektionalen Beziehungen 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

Fehlerkorrekturen für SPARQL

• Der SPARQL-Parser wurde korrigiert, um die Analysezeit für große Abfragen wie INSERT DATA mit vielen Triples und großen Tokens zu verbessern.

Behebung des Cache-Problems mit dem Abfrageplan

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}

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 diesen Versionen in Abfragesprachen kompatibel ist:

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

• Die neueste unterstützte Version von Gremlin: 3.7.1

• openCypher-Version: Neptune-9.0.20190305-1.0

• SPARQL-Version: 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 des SDK aktualisieren. Mit dem folgenden CLI-Befehl wird ein geeignetes 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 Hauptversions-Upgrade 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.