View a markdown version of this page

Neptune-Labor-Modus - 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.

Neptune-Labor-Modus

Sie können den Labor-Modus von Amazon Neptune verwenden, um neue Features zu aktivieren, die in der aktuellen Neptune-Engine-Version enthalten sind, aber noch nicht für die Produktion bereit sind und daher standardmäßig nicht aktiviert sind. Auf diese Weise können Sie diese Features in Ihren Entwicklungs- und Testumgebungen ausprobieren.

Verwenden des Neptune-Labor-Modus

Verwenden Sie den neptune_lab_mode-DB-Cluster-Parameter, um Features zu aktivieren oder zu deaktivieren. Dazu schließen Sie (feature name)=enabled oder (feature name)=disabled in den Wert des neptune_lab_mode-Parameters in der DB-Cluster-Parametergruppe ein.

In dieser Engine-Version können Sie beispielsweise den neptune_lab_mode-Parameter auf Streams=disabled, ReadWriteConflictDetection=enabled festlegen.

Weitere Informationen zum Bearbeiten der DB-Cluster-Parametergruppe für Ihre Datenbank finden Sie unter Bearbeiten einer Parametergruppe. Beachten Sie, dass Sie die Standard-DB-Cluster-Parametergruppe nicht bearbeiten können. Wenn Sie die Standardgruppe verwenden, müssen Sie eine neue DB-Cluster-Parametergruppe erstellen, bevor Sie den neptune_lab_mode-Parameter festlegen können.

Anmerkung

Wenn Sie einen statischen DB-Cluster-Parameter wie neptune_lab_mode ändern, müssen Sie die primäre (Writer-)Instance des Clusters neu starten, damit die Änderung wirksam wird. Vor Release: 1.2.0.0 (21.07.2022) wurden alle Read-Replicas in einem DB-Cluster automatisch neu gestartet, wenn die primäre Instance neu gestartet wurde.

Ab Release: 1.2.0.0 (21.07.2022) führt ein Neustart der primären Instance nicht dazu, dass Replicas neu gestartet werden. Das bedeutet, dass Sie jede Instance getrennt neu starten müssen, um die Änderung eines DB-Cluster-Parameters zu übernehmen (siehe Parametergruppen).

Wichtig

Wenn Sie die falschen Labor-Modus-Parameter angeben oder Ihre Anfrage aus einem anderen Grund fehlschlägt, werden Sie zurzeit möglicherweise nicht über den Fehler informiert. Sie sollten stets überprüfen, ob eine Änderungsanforderung im Labor-Modus erfolgreich war, indem Sie die Status-API aufrufen, wie unten gezeigt:

curl -G https://your-neptune-endpoint:port/status

Die Statusergebnisse enthalten Labor-Modus-Informationen, aus denen hervorgeht, ob die von Ihnen angeforderten Änderungen ausgeführt wurden oder nicht:

{ "status":"healthy", "startTime":"Wed Dec 29 02:29:24 UTC 2021", "dbEngineVersion":"development", "role":"writer", "dfeQueryEngine":"viaQueryHint", "gremlin":{"version":"tinkerpop-3.5.2"}, "sparql":{"version":"sparql-1.1"}, "opencypher":{"version":"Neptune-9.0.20190305-1.0"}, "labMode":{ "ObjectIndex":"disabled", "ReadWriteConflictDetection":"enabled" }, "features":{ "LookupCache":{"status":"Available"}, "ResultCache":{"status":"disabled"}, "IAMAuthentication":"disabled", "Streams":"disabled", "AuditLog":"disabled" }, "settings":{"clusterQueryTimeoutInMs":"120000"} }

Sie können im Labor-Modus auf die folgenden Features zugreifen:

Der OSGP-Index

Neptune kann nun einen vierten Index verwalten, den OSGP-Index, der für Datensätze mit einer großen Anzahl von Prädikaten nützlich ist (siehe Aktivieren eines OSGP-Indexes).

Sie können einen OSGP-Index in einem neuen, leeren Neptune-DB-Cluster aktivieren, indem Sie im neptune_lab_mode-DB-Cluster-Parameter ObjectIndex=enabled festlegen. Ein OSGP-Index kann nur in einem neuen, leeren DB-Cluster aktiviert werden.

Standardmäßig ist der OSPG-Index deaktiviert.

Anmerkung

Nachdem Sie den DB-Cluster-Parameter neptune_lab_mode für die Unterstützung des OSGP-Index eingerichtet haben, müssen Sie die Writer-Instance des Clusters neu starten, damit die Änderung wirksam wird.

Warnung

Wenn Sie einen aktivierten OSGP-Index durch folgende Einstellung deaktivieren ObjectIndex=disabled und wenn Sie ihn später wieder aktivieren, nachdem Sie weitere Daten hinzugefügt haben, wird der Index nicht korrekt erstellt. On-demand Das Neuerstellen des Indexes wird nicht unterstützt, daher sollten Sie den OSGP-Index nur aktivieren, wenn die Datenbank leer ist.

Die Wörterbuch-Garbage Collection wird aktiviert

Die Wörterbuch-Garbage-Collection kann für Eigenschaftsdiagrammdaten aktiviert werden, wenn Neptune-Streams nicht aktiviert sind. Verwenden Sie dazu DictionaryGCMode Parameter. Die Parallelität kann über den gesteuert werden DictionaryGCConcurrency Parameter. Weitere Details finden Sie unter Wörterbuch: Müllabfuhr.

Formalisierte Transaktionssemantik

Neptune hat die formale Semantik für gleichzeitige Transaktionen aktualisiert (siehe Transaktionssemantik in Neptune).

Verwenden Sie ReadWriteConflictDetection als Namen in dem neptune_lab_mode-Parameter, der die formalisierte Transaktionssemantik aktiviert oder deaktiviert.

Standardmäßig ist die formalisierte Transaktionssemantik bereits aktiviert. Wenn Sie zum früheren Verhalten zurückkehren möchten, nehmen Sie ReadWriteConflictDetection=disabled in den Wert für den DB-Cluster-neptune_lab_mode-Parameter auf.

Erweiterte Datetime-Unterstützung

Neptune hat die Unterstützung für die Datetime-Funktionalität erweitert. Um Datetime mit erweiterten Formaten zu aktivieren, geben Sie Folgendes ein DatetimeMillisecond=enabled in dem für den DB-Cluster festgelegten Wert neptune_lab_mode Parameter.

StrictTimeoutValidation

Anmerkung

Diese Funktion ist ab dem Jahr verfügbar Version 1.3.2.0 der Neptune-Engine.

Standardwert: aktiviert (standardmäßig deaktiviert vor Neptune-Engine, Version 1.4.0.0)

Zulässige Werte: enabled/disabled

Wenn dieser Parameter ist enabled, ein Timeout-Wert pro Abfrage, der als Anforderungsoption oder als Abfragehinweis angegeben ist, darf den global in der neptune_query_timeout Parametergruppeneinstellung. Wenn der Timeout pro Abfrage die globale Einstellung überschreitet, gibt Neptune einen InvalidParameterException. In Engine-Versionen vor 1.4.0.0 war dieser Parameter disabled standardmäßig und musste explizit aktiviert werden.

Diese Einstellung kann in einer Antwort auf der bestätigt werden /status Endpunkt, wenn der Wert disabled.

Weitere Informationen finden Sie unter Zeitüberschreitungen pro Abfrage.

AccurateQRCMemoryEstimation

Anmerkung

Diese Funktion ist ab dem Jahr verfügbar Version 1.4.0.0 der Neptune-Engine.

Standardwert: deaktiviert

Zulässige Werte: enabled/disabled

Cache für Gremlin-Abfrageergebnisse, wenn aktiviert, ermöglicht es das Zwischenspeichern von Abfrageergebnissen in der Datenbank. Standardmäßig wird die ungefähre Schätzung verwendet, um die Größe des zwischengespeicherten Ergebnisses mit diesem Labormodus-Parameter zu bestimmen AccurateQRCMemoryEstimation Wenn diese Option aktiviert ist, verwendet die Größenschätzung für zwischengespeicherte Ergebnisse genaue Größenschätzungen statt Näherungswerte. Dieser Labmode-Parameter ist ab der Neptune-Engine-Version 1.4.0.0 verfügbar.

UndoLogPurgeConfig

Anmerkung

Diese Funktion ist ab dem Jahr verfügbar Version 1.2.0.0 der Neptune-Engine.

Standardwert: default

Zulässige Werte: Standard oder aggressiv

UndoLogPurgeConfig steuert, wie aggressiv Neptune Undo-Logs löscht. Sie aktivieren es über den neptune_lab_mode DB-Cluster-Parameter, indem Sie Folgendes einbeziehen UndoLogPurgeConfig=aggressive im Parameterwert.

Wenn gesetzt auf default, Neptune verwendet die Standardanzahl von Threads für das Undo-Log-Löschen. Wenn gesetzt auf aggressive, Neptune verwendet eine erhöhte Anzahl von Threads, um die Bereinigung von Undo-Logs zu beschleunigen. Die Anzahl der Purge-Threads skaliert mit der Instanzgröße. Wenn Sie diese Einstellung also mit einer größeren Writer-Instanz kombinieren, erhöht sich die Geschwindigkeit, mit der Undo-Logs gelöscht werden.

Das Löschen von Undo-Logs wird nur von der Writer-Instanz durchgeführt. Weil neptune_lab_mode ist ein statischer Parameter, für eine Änderung zu müssen Sie die Writer-Instanz neu starten UndoLogPurgeConfig um wirksam zu werden. Ab Version 1.2.0.0 der Neptune-Engine werden beim Neustart des Writers die Read Replicas nicht mehr neu gestartet. Wenn Sie möchten, dass die Einstellung im Falle eines Failovers auf einem Replikat aktiv ist, müssen Sie dieses Replikat separat neu starten.

Um zur Standardlöschung zurückzukehren, legen Sie Folgendes fest UndoLogPurgeConfig=default in der neptune_lab_mode Parameter und starten Sie die Writer-Instanz neu.

Nachdem die Einstellung aktiv ist, können Sie verfolgen UndoLogListSize und NumUndoPagesPurged CloudWatch Kennzahlen zur Beobachtung der Nettoabflussrate unter Ihrer Produktionslast. Dies ist nützlich, wenn Sie Folgendes mitbringen müssen UndoLogListSize unter dem Schwellenwert, der vor einem Versionsupgrade erforderlich ist (siehe Upgrade zu einer Engine-Version 1.2.0.0 oder höher von einer früheren Engine-Version als 1.2.0.0).