Motore dataplane Neptune, ripristino rapido e struttura generale APIs - Amazon Neptune
GetEngineStatusExecuteFastReset________________________QueryLanguageVersionFastResetToken

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Motore dataplane Neptune, ripristino rapido e struttura generale APIs

Operazioni del motore:

Strutture delle operazioni del motore:

GetEngineStatus (azione)

        Il nome AWS CLI per questa API è:. get-engine-status

Recupera lo stato del database a grafo sull'host.

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione GetEngineStatusneptune-db: IAM in quel cluster.

Richiesta

  • Nessun parametro della richiesta.

Risposta

  • dbEngineVersion: una stringa di tipo string (una stringa con codifica UTF-8).

    Imposta la versione del motore Neptune in esecuzione sul cluster database. Se è stata applicata una patch manualmente a questa versione del motore dopo il rilascio, il numero della versione ha il prefisso Patch-.

  • dfeQueryEngine: una stringa di tipo string (una stringa con codifica UTF-8).

    Da impostare su enabled se il motore DFE è completamente abilitato o su viaQueryHint (impostazione predefinita) se il motore DFE viene utilizzato solo con query per le quali il suggerimento useDFE è impostato su true.

  • features: un array di mappa con coppie chiave-valore in cui:

        Ogni chiave è una stringa di tipo string (una stringa con codifica UTF-8).

        Ogni valore è un documento di tipo document (un contenuto aperto indipendente dal protocollo rappresentato da un modello di dati simile a JSON).

    Contiene informazioni sullo stato delle funzionalità abilitate nel cluster database.

  • gremlin: un oggetto QueryLanguageVersion.

    Contiene informazioni sul linguaggio di query Gremlin disponibile nel cluster. In particolare, contiene un campo di versione che specifica la versione corrente utilizzata dal motore. TinkerPop

  • labMode: un array di mappa con coppie chiave-valore in cui:

        Ogni chiave è una stringa di tipo string (una stringa con codifica UTF-8).

        Ogni valore è una stringa di tipo string (una stringa con codifica UTF-8).

    Contiene le impostazioni della modalità Lab utilizzate dal motore.

  • opencypher: un oggetto QueryLanguageVersion.

    Contiene informazioni sul linguaggio di query openCypher disponibile nel cluster. In particolare, contiene un campo version che specifica la versione corrente di operCypher utilizzata dal motore.

  • role: una stringa di tipo string (una stringa con codifica UTF-8).

    Impostato su reader se l'istanza è una replica di lettura o su writer se è l'istanza principale.

  • rollingBackTrxCount: un numero intero di tipo integer (numero intero a 32 bit con segno).

    Se alcune transazioni vengono ripristinate, questo campo contiene il numero di transazioni. Se non ne esistono, il campo non viene visualizzato.

  • rollingBackTrxEarliestStartTime: una stringa di tipo string (una stringa con codifica UTF-8).

    Impostato sull'ora di inizio della transazione più recente in fase di ripristino. Se non è stato eseguito il rollback di alcuna transazione, il campo non viene visualizzato.

  • settings: un array di mappa con coppie chiave-valore in cui:

        Ogni chiave è una stringa di tipo string (una stringa con codifica UTF-8).

        Ogni valore è una stringa di tipo string (una stringa con codifica UTF-8).

    Contiene informazioni sulle impostazioni correnti sul cluster database. Ad esempio, contiene impostazione attuale per il timeout delle query del cluster (clusterQueryTimeoutInMs).

  • sparql: un oggetto QueryLanguageVersion.

    Contiene informazioni sul linguaggio di query SPARQL disponibile nel cluster. In particolare, contiene un campo version che specifica la versione corrente di SPARQL utilizzata dal motore.

  • startTime: una stringa di tipo string (una stringa con codifica UTF-8).

    Impostato sull’ora UTC in cui è iniziato il processo del server corrente.

  • status: una stringa di tipo string (una stringa con codifica UTF-8).

    Impostato su healthy se l'istanza non presenta problemi. Se l'istanza è in fase di ripristino dopo un arresto anomalo o un riavvio e ci sono transazioni attive in esecuzione dall'ultimo arresto del server, lo stato è impostato su recovery.

Errori

ExecuteFastReset (azione)

        Il nome AWS CLI per questa API è:. execute-fast-reset

La REST API di ripristino rapido consente di ripristinare un grafo Neptune in modo veloce e semplice, rimuovendo tutti i relativi dati.

La procedura di ripristino rapido di Neptune prevede due fasi. Per prima cosa, occorre chiamare ExecuteFastReset con action impostato su initiateDatabaseReset. Viene così restituito un token UUID da includere quando si chiama di nuovo ExecuteFastReset con action impostato su performDatabaseReset. Consulta Svuotamento di un cluster database Amazon Neptune utilizzando l'API di ripristino rapido.

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione ResetDatabaseneptune-db: IAM in quel cluster.

Richiesta

  • action (nella CLI: --action): Obbligatorio: un'azione di tipo string (una stringa con codifica UTF-8).

    L'azione di ripristino rapido. Uno dei seguenti valori:

    • initiateDatabaseReset: questa azione genera un token unico necessario per eseguire effettivamente il ripristino rapido.

    • performDatabaseReset: questa azione utilizza il token generato dall'azione initiateDatabaseReset per eseguire effettivamente il ripristino rapido.

  • token (nella CLI: --token): una stringa di tipo string (una stringa con codifica UTF-8).

    Il token per avviare il ripristino rapido.

Risposta

  • payload: un oggetto FastResetToken.

    Il parametro payload viene restituito solo dall'azione initiateDatabaseReset e contiene il token univoco da utilizzare con l'azione performDatabaseReset per eseguire il ripristino.

  • status: Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

    Il parametro status viene restituito solo per l'azione performDatabaseReset e indica se la richiesta di ripristino rapido è accettata o meno.

Errori

Strutture delle operazioni del motore:

QueryLanguageVersion (struttura)

Struttura per esprimere la versione del linguaggio di query.

Campi

  • version: Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

    La versione del linguaggio di query.

FastResetToken (struttura)

Una struttura contenente il token utilizzato per avviare un ripristino rapido.

Campi

  • token: questa è una stringa di tipo string (una stringa con codifica UTF-8).

    Un UUID generato dal database durante l'azione initiateDatabaseReset e poi utilizzato da performDatabaseReset per reimpostare il database.