Amazon Neptune Engine-Version 1.2.1.0.R3 (13.06.2023) - Amazon Neptune
Neue FeaturesVerbesserungenBehobene FehlerUnterstützte Versionen in AbfragespracheUpgrade-PfadeWird geupgradet

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.2.1.0.R3 (13.06.2023)

Ab dem 13.06.2023 wird die Engine-Version 1.2.1.0.R3 allgemein bereitgestellt. Bitte beachten Sie, dass es mehrere Tage dauert, bis eine neue Version in jeder Region verfügbar ist.

Wichtig

Die in dieser Engine-Version eingeführten Änderungen können in einigen Fällen dazu führen, dass Sie eine verringerte Leistung beim Laden von Massenladevorgängen feststellen. Aus diesem Grund wurden die Upgrades dieser Version vorübergehend ausgesetzt, bis das Problem behoben ist.

Anmerkung

Bei einem Upgrade von einer Engine-Version vor 1.2.0.0:

  • Mit der Engine-Version 1.2.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.2.0.0 auf Engine-Version 1.2.0.0 oder höher aktualisieren, müssen Sie alle vorhandenen benutzerdefinierten Parametergruppen und benutzerdefinierten Cluster-Parametergruppen mithilfe der Parametergruppenfamilie neptune1.2 neu erstellen. In früheren Versionen wurde die Parametergruppenfamilie neptune1 verwendet und diese Parametergruppen funktionieren nicht mit Version 1.2.0.0 und höher. Weitere Informationen finden Sie unter Amazon-Neptune-Parametergruppen.

  • Mit der Engine-Version 1.2.0.0 wurde auch ein neues Format für Undo-Protokolle eingeführt. Daher müssen alle Undo-Protokolle, die von einer früheren Engine-Version erstellt wurden, gelöscht werden und die CloudWatch-Metrik UndoLogsListSize muss auf Null fallen, bevor ein Upgrade von einer Version vor 1.2.0.0 gestartet werden kann. Wenn beim Versuch, ein Update zu starten, zu viele Undo-Protokolldatensätze (200.000 oder mehr) vorhanden sind, kann es beim Upgrade-Versuch zu einer Zeitüberschreitung kommen, während auf den Abschluss des Löschvorgangs der Undo-Protokolle gewartet wird.

    Sie können die Löschgeschwindigkeit beschleunigen, indem Sie die Writer-Instance des Clusters aktualisieren, in der das Löschen stattfindet. Wenn Sie dies tun, bevor Sie versuchen, das Upgrade durchzuführen, kann die Anzahl der Undo-Logs vor dem Start reduziert werden. Wenn Sie die Größe des Writers auf einen 24XL-Instance-Typ erhöhen, kann sich Ihre Löschrate auf mehr als eine Million Datensätze pro Stunde erhöhen.

    Wenn die UndoLogsListSize-CloudWatch-Metrik extrem umfangreich ist, kann Ihnen die Eröffnung eines Support-Falls dabei helfen, zusätzliche Strategien zu finden, um sie zu reduzieren.

  • Schließlich wurde mit Version 1.2.0.0 eine bahnbrechende Änderung eingeführt, die sich auf früheren Code auswirkt, der das Bolt-Protokoll mit IAM-Authentifizierung verwendete. Ab Version 1.2.0.0 benötigt Bolt einen Ressourcenpfad für die IAM-Signatur. In Java könnte das Festlegen des Ressourcenpfads so aussehen: request.setResourcePath("/openCypher"));. In anderen Sprachen kann /openCypher an den Endpunkt-URI angehängt werden. Beispiele finden Sie unter Verwenden des Bolt-Protokolls.

Neue Features in dieser Engine-Version

  • Unterstützung für kontoübergreifendes Massenladen mithilfe der IAM-Rollenverkettung wurde hinzugefügt.

Verbesserungen in dieser Engine-Version

  • Der fail()-Schritt von Gremlin wurde verbessert, um die erzeugte Ausnahme von einer generischen Ausnahme zu unterscheiden InternalFailureException und sicherzustellen, dass alle vom Benutzer bereitgestellten Nachrichten an den Aufrufer zurückgesendet wurden.

  • Die Optimierungen der Gremlin-Abfrage-Engine für store, aggregate, cap, limit und hasLabel wurden verbessert.

  • Unterstützung für trignometrische Features von openCypher hinzugefügt:

    • acos()

    • asin()

    • atan()

    • atan2()

    • cos()

    • cot()

    • degrees()

    • pi()

    • radians()

    • sin()

    • tan()

  • Unterstützung für mehrere Aggregationsfunktionen von openCypher hinzugefügt:

    • percentileDisc()

    • stDev()

  • Unterstützung für die openCypher-epochmillis()-Funktion hinzugefügt, die ein datetime in epochmillis umwandelt. Beispiel:

    MATCH (n) RETURN epochMillis(n.someDateTime)
1698972364782

  • Unterstützung für den openCypher-Operator modulo (%) hinzugefügt.

  • Unterstützung für das openCypher Static Debug-Erklärungs-Tool hinzugefügt.

  • Unterstützung für die openCypher-randomUUID()-Funktion hinzugefügt.

  • Verbesserung der Leistung von openCypher:

    • Der Parser und der Abfrageplaner wurden verbessert.

    • Verbesserung der CPU-Auslastung in der DFE-Engine.

    • Die Leistung von Abfragen mit mehreren Aktualisierungsklauseln, die dieselben Variablen wiederverwenden, wurde verbessert. Beispiele sind:

      MERGE (n {name: 'John'})
  or
MERGE (m {name: 'Jim'})
  or
MERGE (n)-[:knows {since: 2023}]→(m)

    • Optimierte Abfragepläne für Multi-Hop-Abfragemuster wie:

      MATCH (n)-->()-->()-->(m)
RETURN n m

    • Die Leistung der Listen- und Map-Injection durch parametrisierte Abfragen wurde verbessert. Beispiel:

      UNWIND $idList as id MATCH (n {`~id`: id})
RETURN n.name

    • Die Ausführung von Abfragen mit WITH wurde verbessert, indem es zu einer geeigneten Barriere gemacht wurde.

    • Optimiert, um eine redundante Materialisierung von Werten in Unfold und Aggregationsfunktionen zu vermeiden.

  • Die Leistung von SPARQL-Abfragen, die eine große Anzahl statischer Eingaben in der VALUES-Klausel enthalten, wie z. B.:

    SELECT ?n WHERE { VALUES (?name) { ("John") ("Jim") ... many values ... } ?n a ?n_type . ?n ?name . }

  • Verbesserung der SPARQL CBD-Abfrageleistung.

In diesem Engine-Version behobene Fehler

  • Es wurde ein Gremlin-Fehler behoben, bei dem lange Abfragen mit tiefer Verschachtelung zu einer hohen CPU-Auslastung und Abfrage-Timeouts während der Abfrageplanungsphase führten.

  • Es wurde ein Gremlin-Fehler behoben, durch den bei Verwendung von mergeV oder mergeE ein ungültiges NullPointerException ausgegeben werden konnte.

In dieser Version unterstützte Versionen in Abfragesprache

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

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

  • Die neueste unterstützte Version von Gremlin: 3.6.2

  • openCypher-Version: Neptune-9.0.20190305-1.0

  • SPARQL-Version: 1.1

Upgrade-Pfade zum Engine-Release 1.2.1.0.R3

Upgrade auf diesen Release

Amazon Neptune 1.2.1.0.R3 ist jetzt allgemein verfügbar.

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.2.1.0 \
    --apply-immediately

Für Windows:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.2.1.0 ^
    --apply-immediately

Updates werden auf alle Instances in einem DB-Cluster gleichzeitig angewendet. Ein Update erfordert einen Datenbankneustart auf diesen Instances. Daher kommt es zu einer Ausfallzeit von 20–30 Sekunden bis zu mehreren Minuten. Anschließend können Sie die Nutzung Ihres DB-Clusters fortsetzen.

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. Bei Fragen oder Bedenken steht Ihnen das AWS Support-Team in den Community-Foren und über AWS Premium Support zur Verfügung.