API delle statistiche del piano dati e di riepilogo del grafo di Neptune - Amazon Neptune

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à.

API delle statistiche del piano dati e di riepilogo del grafo di Neptune

Azioni delle statistiche del grafo delle proprietà:

Strutture delle statistiche:

GetPropertygraphStatistics (azione)

        Il nome AWS CLI per questa API è: get-propertygraph-statistics.

Ottiene le statistiche del grafo delle proprietà (Gremlin e openCypher).

Quando si richiama questa operazione in un cluster Neptune in cui è abilitata l'autenticazione IAM, all'utente o al ruolo IAM che effettua la richiesta deve essere associata una policy che consenta l'azione IAM neptune-db:GetStatisticsStatus nel cluster.

Richiesta
  • Nessun parametro della richiesta.

Risposta

  • payload: obbligatorio: un oggetto Statistiche.

    Statistiche per i dati del grafo delle proprietà.

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

    Il codice HTTP restituito della richiesta. Se la richiesta è riuscita, il codice è 200. Per un elenco degli errori più comuni, consulta Codici di errore comuni per la richiesta di statistiche DFE.

ManagePropertygraphStatistics (azione)

        Il nome AWS CLI per questa API è: manage-propertygraph-statistics.

Gestisce la generazione e l'uso delle statistiche del grafo delle proprietà.

Quando si richiama questa operazione in un cluster Neptune in cui è abilitata l'autenticazione IAM, all'utente o al ruolo IAM che effettua la richiesta deve essere associata una policy che consenta l'azione IAM neptune-db:ManageStatistics nel cluster.

Richiesta

  • mode (nella CLI: --mode): un valore StatisticsAutoGenerationMode di tipo string (una stringa con codifica UTF-8).

    La modalità di generazione delle statistiche. Una di DISABLE_AUTOCOMPUTE, ENABLE_AUTOCOMPUTE oREFRESH, l'ultimo dei quali attiva manualmente la generazione delle statistiche DFE.

Risposta

  • payload: un oggetto RefreshStatisticsIdMap.

    Viene restituito solo per la modalità di aggiornamento.

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

    Il codice HTTP restituito della richiesta. Se la richiesta è riuscita, il codice è 200.

DeletePropertygraphStatistics (azione)

        Il nome AWS CLI per questa API è: delete-propertygraph-statistics.

Elimina le statistiche per i dati di Gremlin e openCypher (grafo delle proprietà).

Quando si richiama questa operazione in un cluster Neptune in cui è abilitata l'autenticazione IAM, all'utente o al ruolo IAM che effettua la richiesta deve essere associata una policy che consenta l'azione IAM neptune-db:DeleteStatistics nel cluster.

Richiesta
  • Nessun parametro della richiesta.

Risposta

  • payload: un oggetto DeleteStatisticsValueMap.

    Payload dell'eliminazione.

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

    Lo stato di annullamento.

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

    Il codice di risposta HTTP: 200 se l'eliminazione è riuscita o 204 se non esistevano statistiche da eliminare.

GetPropertygraphSummary (azione)

        Il nome AWS CLI per questa API è: get-propertygraph-summary.

Ottiene un riepilogo per un grafo delle proprietà.

Quando si richiama questa operazione in un cluster Neptune in cui è abilitata l'autenticazione IAM, all'utente o al ruolo IAM che effettua la richiesta deve essere associata una policy che consenta l'azione IAM neptune-db:GetGraphSummary nel cluster.

Richiesta

  • mode (nella CLI: --mode): un valore GraphSummaryType di tipo string (una stringa con codifica UTF-8).

    La modalità può avere uno dei due valori: BASIC (predefinito) e DETAILED.

Risposta

  • payload: un oggetto PropertygraphSummaryValueMap.

    Payload contenente la risposta riassuntiva del grafo delle proprietà.

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

    Il codice HTTP restituito della richiesta. Se la richiesta è riuscita, il codice è 200.

Strutture delle statistiche:

Statistics (struttura)

Contiene informazioni sulle statistiche. Il motore DFE utilizza le informazioni sui dati del grafo Neptune per trovare compromessi efficaci al momento di pianificare l'esecuzione delle query. Queste informazioni assumono la forma di statistiche che includono i cosiddetti insiemi di caratteristiche, nonché statistiche sui predicati utili per la pianificazione delle query. Consulta Gestione delle statistiche utilizzabili dal motore DFE di Neptune.

Campi
  • active: questo è un valore booleano di tipo boolean [un valore booleano (vero o falso)].

    Indica se la generazione di statistiche DFE è abilitata o meno.

  • autoCompute: questo è un valore booleano di tipo boolean [un valore booleano (vero o falso)].

    Indica se la generazione automatica di statistiche è abilitata o meno.

  • date: questo è un valore SyntheticTimestamp_date_time di tipo string (una stringa con codifica UTF-8).

    L'ora UTC in cui sono state generate le statistiche DFE più recentemente.

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

    Una nota sui problemi nel caso in cui le statistiche non siano valide.

  • signatureInfo: questo è un oggetto StatisticsSummary.

    Una struttura StatisticsSummary che contiene:

    • signatureCount: numero totale di firme in tutti i set di caratteristiche.

    • instanceCount: numero totale di istanze di set di caratteristiche.

    • predicateCount: numero totale di predicati univoci.

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

    Riporta l'ID dell'esecuzione corrente della generazione delle statistiche. Il valore -1 indica che non sono state generate statistiche.

StatisticsSummary (struttura)

Informazioni sui set di caratteristiche generati nelle statistiche.

Campi
  • instanceCount: questo è un numero intero di tipo integer(numero intero a 32 bit con segno).

    : numero totale di istanze di set di caratteristiche.

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

    Il numero totale di predicati univoci.

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

    Il numero totale di firme in tutti i set di caratteristiche.

DeleteStatisticsValueMap (struttura)

Il payload per DeleteStatistics.

Campi
  • active: questo è un valore booleano di tipo boolean [un valore booleano (vero o falso)].

    Lo stato corrente delle statistiche.

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

    L'ID dell'esecuzione attualmente in corso per la generazione delle statistiche.

RefreshStatisticsIdMap (struttura)

Statistiche per la modalità REFRESH.

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

    L'ID dell'esecuzione attualmente in corso per la generazione delle statistiche.

NodeStructure (struttura)

Una struttura di nodi.

Campi
  • count: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Numero di nodi con questa struttura specifica.

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

    Un elenco di etichette di archi in uscita distinte in questa struttura specifica.

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

    Un elenco delle proprietà dei nodi in questa struttura specifica.

EdgeStructure (struttura)

Una struttura di archi.

Campi
  • count: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Numero di archi con questa struttura specifica.

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

    Un elenco di proprietà di arco in questa struttura specifica.

SubjectStructure (struttura)

Una struttura di argomenti.

Campi
  • count: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Numero di occorrenze di questa struttura specifica.

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

    Un elenco di predicati presenti in questa struttura specifica.

PropertygraphSummaryValueMap (struttura)

Payload per la risposta riassuntiva del grafo delle proprietà.

Campi
  • graphSummary: questo è un oggetto PropertygraphSummary.

    Il riepilogo del grafo.

  • lastStatisticsComputationTime: questo è un valore SyntheticTimestamp_date_time di tipo string (una stringa con codifica UTF-8).

    Il timestamp, in formato ISO 8601, dell'ora in cui Neptune ha calcolato le statistiche per l'ultima volta.

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

    La versione della risposta riassuntiva del grafo.

PropertygraphSummary (struttura)

L'API di riepilogo del grafo restituisce un elenco di sola lettura di etichette di nodi e archi, nonché di chiavi di proprietà, insieme al conteggio di nodi, archi e proprietà. Consulta Risposta riepilogativa per un grafo delle proprietà.

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

    Un elenco di etichette di arco distinte nel grafo.

  • edgeProperties: si tratta di oggetti LongValuedMap ed è 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 oggetto Long di tipo long (numero intero a 64 bit con segno).

    Un elenco di proprietà di arco distinte nel grafo, insieme al numero di archi in cui viene utilizzata ciascuna proprietà.

  • edgeStructures: questo è un array di oggetti EdgeStructure.

    Questo campo è presente solo se la modalità richiesta èDETAILED. Contiene un elenco di strutture di archi.

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

    Un elenco di etichette di nodi distinte nel grafo.

  • nodeProperties: si tratta di oggetti LongValuedMap ed è 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 oggetto Long di tipo long (numero intero a 64 bit con segno).

    Il numero di proprietà di nodi distinte nel grafo.

  • nodeStructures: questo è un array di oggetti NodeStructure.

    Questo campo è presente solo se la modalità richiesta èDETAILED. Contiene un elenco di strutture di nodi.

  • numEdgeLabels: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Il numero di etichette di arco distinte nel grafo.

  • numEdgeProperties: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Il numero di proprietà di arco distinte nel grafo.

  • numEdges: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Il numero di archi nel grafo.

  • numNodeLabels: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Il numero di etichette di nodi distinte nel grafo.

  • numNodeProperties: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Un elenco di proprietà di nodi distinte nel grafo, insieme al numero di nodi in cui viene utilizzata ciascuna proprietà.

  • numNodes: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Il numero di nodi nel grafo.

  • totalEdgePropertyValues: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Il numero totale di utilizzi di tutte le proprietà di arco.

  • totalNodePropertyValues: questo è un valore Long di tipo long (numero intero a 64 bit con segno).

    Il numero totale di utilizzi di tutte le proprietà di nodi.