Neptune-Dataplane-Engine, schneller Reset und allgemeine Struktur APIs

• GetEngineStatus (Aktion)

• ExecuteFastReset (Aktion)

• QueryLanguageVersion (Struktur)

• FastResetToken (Struktur)

Anforderung

• Keine Anforderungsparameter.

• dbEngineVersion – eine Zeichenfolge vom Typ: string (UTF-8-kodierte Zeichenfolge).

  Stellen Sie die Version der Neptune-Engine ein, die in Ihrem DB-Cluster ausgeführt wird. Wenn diese Engine-Version nach ihrer Freigabe manuell gepatcht wurde, wird der Versionsnummer der Zusatz Patch- vorangestellt.

• dfeQueryEngine – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Wird auf enabled gesetzt, wenn die DFE-Engine vollständig aktiviert ist, oder auf viaQueryHint (Standardeinstellung), wenn die DFE-Engine nur für Abfragen verwendet wird, bei denen der useDFE-Abfragehinweis auf true festgelegt ist.

• features   – Ein Map-Array von Schlüssel-Wert-Paaren, wobei Folgendes gilt:

      Jeder Schlüssel ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

      Jeder Wert ist ein Dokument vom Typ document (protokollunabhängiger offener Inhalt, der durch ein JSON-ähnliches Datenmodell repräsentiert wird).

  Enthält Statusinformationen zu den im DB-Cluster aktivierten Funktionen.

• gremlin   – Ein QueryLanguageVersion-Objekt.

  Enthält Informationen zur Gremlin-Abfragesprache, die im Cluster verfügbar ist. Insbesondere enthält es ein Versionsfeld, das die aktuelle Version angibt, die von der Engine verwendet wird. TinkerPop

• labMode   – Ein Map-Array von Schlüssel-Wert-Paaren, wobei Folgendes gilt:

      Jeder Schlüssel ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

      Jeder Wert ist eine Zeichenfolge vom Typ string (eine UTF-8-kodierte Zeichenfolge).

  Enthält Einstellungen des Labor-Modus, die von der Engine verwendet werden.

• opencypher   – Ein QueryLanguageVersion-Objekt.

  Enthält Informationen über die openCypher-Abfragesprache, die im Cluster verfügbar ist. Insbesondere enthält es ein Versionsfeld, in dem die aktuelle von der Engine verwendete operCypher-Version angegeben ist.

• role – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Dieses Feld wird auf reader festgelegt, wenn die Instance ein Read Replica ist, oder auf writer, wenn es sich um die primäre Instance handelt.

• rollingBackTrxCount   – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

  Wenn Transaktionen rückgängig gemacht werden, wird dieses Feld auf die Anzahl solcher Transaktionen festgelegt. Wenn keine Transaktionen vorhanden sind, wird das Feld nicht angezeigt.

• rollingBackTrxEarliestStartTime – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Wird auf die Startzeit der frühesten Transaktion festgelegt, die rückgängig gemacht wird. Wenn keine Transaktionen zurückgesetzt werden, wird dieses Feld nicht im Status angezeigt.

• settings   – Ein Map-Array von Schlüssel-Wert-Paaren, wobei Folgendes gilt:

      Jeder Schlüssel ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

      Jeder Wert ist eine Zeichenfolge vom Typ string (eine UTF-8-kodierte Zeichenfolge).

  Enthält Informationen über die aktuellen Einstellungen des DB-Clusters. Enthält beispielsweise die aktuelle Einstellung für den Timeout von Cluster-Abfragen (clusterQueryTimeoutInMs).

• sparql   – Ein QueryLanguageVersion-Objekt.

  Enthält Informationen über die SPARQL-Abfragesprache, die im Cluster verfügbar ist. Insbesondere enthält es ein Versionsfeld, in dem die aktuelle von der Engine verwendete SPARQL-Version angegeben ist.

• startTime – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Ist auf die UTC-Zeit eingestellt, zu der der aktuelle Serverprozess gestartet wird.

• status – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Wird auf healthy gesetzt, wenn bei der Instance keine Probleme auftreten. Wenn die Instance nach einem Ausfall oder Neustart wiederhergestellt wird und noch aktive Transaktionen vom letzten Herunterfahren des Servers ausgeführt werden, wird als Status recovery festgelegt.

Fehler

• UnsupportedOperationException

• InternalFailureException

• ClientTimeoutException

• PreconditionsFailedException

• ConstraintViolationException

• InvalidArgumentException

• IllegalArgumentException

• TooManyRequestsException

• action  (in der CLI: --action) – Erforderlich: Eine Aktion vom Typ string (UTF-8-kodierte Zeichenfolge).

  Die Fast-Reset-Aktion. Einer der folgenden Werte:

  • initiateDatabaseReset  –   Durch diese Aktion wird ein eindeutiges Token generiert, das für die tatsächliche Ausführung des Fast Reset benötigt wird.

  • performDatabaseReset   –   Diese Aktion verwendet das von der initiateDatabaseReset-Aktion generierte Token, um den Fast Reset tatsächlich auszuführen.

• token  (in der CLI: --token) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Das Fast-Reset-Token zur Einleitung des Reset.

• payload – Ein FastResetToken-Objekt.

  Die payload wird nur von der initiateDatabaseReset-Aktion zurückgegeben und enthält das eindeutige Token, das zusammen mit der performDatabaseReset-Aktion verwendet werden soll, um den Reset auszuführen.

• status   – Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Der status wird nur für die performDatabaseReset-Aktion zurückgegeben und gibt an, ob die Fast-Reset-Anforderung akzeptiert wurde oder nicht.

Fehler

• InvalidParameterException

• ClientTimeoutException

• AccessDeniedException

• IllegalArgumentException

• TooManyRequestsException

• UnsupportedOperationException

• ServerShutdownException

• PreconditionsFailedException

• MethodNotAllowedException

• ReadOnlyViolationException

• ConstraintViolationException

• InvalidArgumentException

• MissingParameterException

Felder

• version – Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Die Version der Abfragesprache.

Felder

• token – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

  Eine UUID, die von der Datenbank in der initiateDatabaseReset-Aktion generiert und dann von der performDatabaseReset verwendet wird, um die Datenbank zurückzusetzen.