Moteur de plan de données Neptune, réinitialisation rapide et API de structure générale - Amazon Neptune
GetEngineStatusExecuteFastReset________________________QueryLanguageVersionFastResetToken

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Moteur de plan de données Neptune, réinitialisation rapide et API de structure générale

Fonctionnement du moteur :

Structures de fonctionnement du moteur :

GetEngineStatus (action)

        Le nom AWS CLI de cette API est : get-engine-status.

Récupère le statut de la base de données orientée graphe sur l'hôte.

Lorsque vous invoquez cette opération dans un cluster Neptune pour lequel l'authentification IAM est activée, l'utilisateur ou le rôle IAM à l'origine de la demande doit être associé à une politique autorisant l'action IAM neptune-db:GetEngineStatus dans ce cluster.

Demande

  • Aucun paramètre de demande.

Réponse

  • dbEngineVersion : chaîne de type : string (chaîne encodée en UTF-8).

    Définissez la version de moteur Neptune exécutée sur votre cluster de bases de données. Si cette version de moteur a été corrigée manuellement depuis sa publication, le numéro de version est préfixé par Patch-.

  • dfeQueryEngine : chaîne de type : string (chaîne encodée en UTF-8).

    Définie sur enabled si le moteur DFE est complètement activé, ou sur viaQueryHint (valeur par défaut) si le moteur DFE n'est utilisé qu'avec les requêtes dont l'indicateur de requête useDFE est défini sur. true

  • features : tableau de mappage de paires clé-valeur où :

        Chaque clé est une chaîne de type : string (chaîne encodée en UTF-8).

        Chaque valeur est un document de type : document (contenu ouvert indépendant du protocole représenté par un modèle de données de type JSON).

    Contient des informations d'état sur les fonctionnalités activées sur votre cluster de bases de données.

  • gremlin : objet QueryLanguageVersion.

    Contient des informations sur le langage de requête Gremlin disponible sur votre cluster. Plus précisément, il contient un champ de version qui spécifie la version actuelle de TinkerPop utilisée par le moteur.

  • labMode : tableau de mappage de paires clé-valeur où :

        Chaque clé est une chaîne de type : string (chaîne encodée en UTF-8).

        Chaque valeur est une chaîne de type : string (chaîne encodée en UTF-8).

    Contient les paramètres de mode expérimental utilisés par le moteur.

  • opencypher : objet QueryLanguageVersion.

    Contient des informations sur le langage de requête openCypher disponible sur votre cluster. Plus précisément, il contient un champ de version qui spécifie la version actuelle d'openCypher utilisée par le moteur.

  • role : chaîne de type : string (chaîne encodée en UTF-8).

    Définie sur reader si l'instance est un réplica en lecture ou sur writer si l'instance est l'instance principale.

  • rollingBackTrxCount : entier de type : integer (entier signé de 32 bits).

    Si des transactions sont annulées, ce champ est défini sur le nombre de transactions de ce type. S'il n'y en a pas, ce champ ne s'affiche pas.

  • rollingBackTrxEarliestStartTime : chaîne de type : string (chaîne encodée en UTF-8).

    Heure de début de la transaction la plus ancienne annulée. Si aucune transaction n'est annulée, ce champ ne s'affiche pas.

  • settings : tableau de mappage de paires clé-valeur où :

        Chaque clé est une chaîne de type : string (chaîne encodée en UTF-8).

        Chaque valeur est une chaîne de type : string (chaîne encodée en UTF-8).

    Contient des informations sur les paramètres actuels de votre cluster de bases de données. Par exemple, contient le paramètre actuel d'expiration des requêtes du cluster (clusterQueryTimeoutInMs).

  • sparql : objet QueryLanguageVersion.

    Contient des informations sur le langage de requête SPARQL disponible sur votre cluster. Plus précisément, il contient un champ de version qui spécifie la version actuelle de SPARQL utilisée par le moteur.

  • startTime : chaîne de type : string (chaîne encodée en UTF-8).

    Définie sur l'heure UTC (heure universelle coordonnée) à laquelle le processus serveur actuel a démarré.

  • status : chaîne de type : string (chaîne encodée en UTF-8).

    Définie sur healthy si l'instance ne rencontre aucun problème. Si l'instance est en cours de récupération suite à un incident ou parce qu'elle a été redémarrée et qu'il existe des transactions actives en cours d'exécution depuis le dernier arrêt de serveur, le statut est défini sur recovery.

Erreurs

ExecuteFastReset (action)

        Le nom AWS CLI de cette API est : execute-fast-reset.

L'API REST de réinitialisation rapide vous permet de réinitialiser un graphe Neptune rapidement et facilement, en supprimant toutes ses données.

La réinitialisation rapide de Neptune est un processus en deux étapes. Vous appelez d'abord ExecuteFastReset avec l'attribut action défini sur initiateDatabaseReset. Cette opération renvoie un jeton UUID que vous incluerez ensuite lors d'un nouvel appel d'ExecuteFastReset avec l'attribut action défini sur performDatabaseReset. Consultez Vider un cluster de bases de données Amazon Neptune à l'aide de l'API de réinitialisation rapide.

Lorsque vous invoquez cette opération dans un cluster Neptune pour lequel l'authentification IAM est activée, l'utilisateur ou le rôle IAM à l'origine de la demande doit être associé à une politique autorisant l'action IAM neptune-db:ResetDatabase dans ce cluster.

Demande

  • action (dans la CLI : --action) : obligatoire : action de type : string (chaîne encodée en UTF-8).

    Action de réinitialisation rapide. L'une des valeurs suivantes :

    • initiateDatabaseReset : cette action génère un jeton unique nécessaire pour effectuer réellement la réinitialisation rapide.

    • performDatabaseReset : cette action utilise le jeton généré par l'action initiateDatabaseResetpour effectuer réellement la réinitialisation rapide.

  • token (dans la CLI : --token) : chaîne de type : string (chaîne encodée en UTF-8).

    Jeton de réinitialisation rapide permettant de lancer la réinitialisation.

Réponse

  • payload : objet FastResetToken.

    La valeur payload n'est renvoyée que par l'action initiateDatabaseReset et contient le jeton unique à utiliser avec l'action performDatabaseResetpour effectuer la réinitialisation.

  • status : obligatoire : chaîne de type : string (chaîne encodée en UTF-8).

    La valeur status n'est renvoyée que pour l'action performDatabaseReset et indique si la demande de réinitialisation rapide est acceptée ou non.

Erreurs

Structures de fonctionnement du moteur :

QueryLanguageVersion (structure)

Structure permettant d'exprimer la version du langage de requête.

Champs

  • version : obligatoire : chaîne de type : string (chaîne encodée en UTF-8).

    Version du langage de requête.

FastResetToken (structure)

Structure contenant le jeton utilisé pour initier une réinitialisation rapide.

Champs

  • token : chaîne de type : string (chaîne encodée en UTF-8).

    UUID généré par la base de données lors de l'action initiateDatabaseReset, puis utilisé par performDatabaseReset pour réinitialiser la base de données.