Amazon Neptune Engine-Version 1.0.4.1 (08.12.2020)

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

Nachfolgende Patch-Veröffentlichungen für dieses Version

• Release: 1.0.4.1.R1.1 (22.03.2021)

• Release: 1.0.4.1.R2 (24.02.2021)

  Wichtig

  Release: 1.0.4.0 (12.10.2020) hat TLS 1.2 und HTTPS für alle Verbindungen zu Amazon Neptune zur Pflicht gemacht. Ein Fehler in diesem Release hat jedoch dazu geführt, dass HTTP-Verbindungen und/oder veraltete TLS-Verbindungen weiterhin für Kunden funktionieren, die zuvor einen DB-Cluster-Parameter festgelegt haben, um die Durchsetzung von HTTPS-Verbindungen zu verhindern.

  Dieser Fehler wurde in den Patch-Versionen 1.0.4.0.R2 und 1.0.4.1.R2 behoben, aber die Behebung hat zu unerwarteten Verbindungsfehlern geführt, wenn die Patches automatisch installiert wurden. Aus diesem Grund wurden beide Patches rückgängig gemacht und können nur manuell installiert werden, um Ihnen die Möglichkeit zu geben, Ihr Setup für TLS 1.2 zu aktualisieren.

  Die Verwendung von SSL/TLS für alle Verbindungen zu Neptune wirkt sich auf Ihre Verbindungen mit der Gremlin-Konsole, dem Gremlin-Treiber, Gremlin Python, .NET, nodeJs, REST-APIs und auch Load Balancer-Verbindungen aus. Wenn Sie bisher HTTP oder eine ältere TLS-Version für einen oder alle diese Bereiche verwendet haben, müssen Sie den entsprechenden Client und die Treiber aktualisieren und Ihren Code so ändern, dass er ausschließlich HTTPS verwendet, bevor Sie Ihr System auf die neuesten Patches aktualisieren.

Neue Features in dieser Engine-Version

• Einführung der Neptune ML-Funktion, die Amazon Neptune leistungsstarke Funktionen für Machine Learning bietet. Siehe Amazon Neptune ML für Machine Learning anhand von Diagrammen.

• Es wurde eine benutzerdefinierte UNLOAD SPARQL-Operation zum Entfernen von Daten hinzugefügt, die aus einer Remote-Quelle abgerufen wurden. Siehe SPARQL UPDATE UNLOAD.

Verbesserungen in dieser Engine-Version

• Einige bedingte Gremlin-Einfügemuster wurden optimiert, um Ausnahmen bei gleichzeitigen Änderungen zu vermeiden.

In diesem Engine-Version behobene Fehler

• Es wurde ein Gremlin-Fehler behoben, der dazu führen konnte, dass Ergebnisse für ein bestimmtes Muster von Abfragen, die den Schritt as() verwendet haben, fehlten.

• Es wurde ein Gremlin-Fehler behoben, der zu Fehlern führen konnte, wenn der Schritt project() in einem anderen Schritt verschachtelt war, wie union().

• Ein Gremlin-Fehler im project()-Schritt wurde behoben.

• Es wurde ein Gremlin-Fehler bei Traversalen von Zeichenketten behoben, bei dem der Schritt none() nicht funktionierte.

• Es wurde ein Gremlin-Fehler bei Traversalen von Zeichenketten behoben, bei dem eine leere Map nicht als Argument für den Schritt inject() unterstützt wurde.

• Es wurde ein Gremlin-Fehler behoben, durch den eine Terminalmethode wie toList() in der DFE-Engine bei der Ausführung auf Zeichenketten basierender Traversalausführung nicht richtig funktionierte.

• Ein Gremlin-Fehler wurde behoben, durch den Transaktionen, die den Schritt iterate() in String-Abfragen verwendeten, nicht geschlossen werden konnten.

• Ein Gremlin-Fehler wurde behoben, der dazu führen konnte, dass Abfragen, die das is(P.gte(0))-Muster verwendeten, in manchen Situationen eine Exception auslösten.

• Ein Gremlin-Fehler wurde behoben, der dazu führen konnte, dass Abfragen, die das order().by(T.id)-Muster verwendeten, in manchen Situationen eine Exception auslösten.

• Ein Gremlin-Fehler wurde behoben, der dazu führen konnte, dass Abfragen, die das addV().aggregate()-Muster verwendeten, in manchen Situationen falsche Ergebnisse lieferten.

• Ein Gremlin-Fehler wurde behoben, der dazu führen konnte, dass Abfragen, die das Schritt-path()-Muster gefolgt von Schritt project() verwendeten, in manchen Situationen eine Exception auslösten.

• Es wurde ein SPARQL-Fehler behoben, bei dem die Funktion SUBSTR einen Fehler signalisiert, anstatt eine leere Zeichenfolge zurückzugeben.

• Es wurde ein Fehler in der DFE-Engine behoben, der dazu führen konnte, dass Join-Operationen in nicht blockierenden Abfrageplänen bei Vorhandensein ungebundener Variablen falsche Ergebnisse generierten.

In dieser Version unterstützte Versionen in Abfragesprache

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

• Gremlin-Version: 3.4.8

• SPARQL-Version: 1.1

Upgrade-Pfade zum Engine-Release 1.0.4.1

Ihr Cluster wird während des nächsten Wartungsfensters automatisch auf diese Patch-Version aktualisiert, wenn Sie die Modulversion 1.0.4.1 ausführen.

Sie können jeden vorherigen Neptune Engine-Release manuell auf diese Version aktualisieren.

Upgrade auf diesen Release

Amazon Neptune 1.0.4.1 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.0.4.1 \
    --apply-immediately

Für Windows:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.0.4.1 ^
    --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.