As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Estatísticas do plano de dados do Neptune e APIs de resumo de grafos
**Ações estatísticas do grafo de propriedades:**
+ [GetPropertygraphStatistics (ação)](#GetPropertygraphStatistics)
+ [ManagePropertygraphStatistics (ação)](#ManagePropertygraphStatistics)
+ [DeletePropertygraphStatistics (ação)](#DeletePropertygraphStatistics)
+ [GetPropertygraphSummary (ação)](#GetPropertygraphSummary)
**Estruturas estatísticas:**
+ [Estatísticas (estrutura)](#Statistics)
+ [StatisticsSummary (estrutura)](#StatisticsSummary)
+ [DeleteStatisticsValueMap (estrutura)](#DeleteStatisticsValueMap)
+ [RefreshStatisticsIdMap (estrutura)](#RefreshStatisticsIdMap)
+ [NodeStructure (estrutura)](#NodeStructure)
+ [EdgeStructure (estrutura)](#EdgeStructure)
+ [SubjectStructure (estrutura)](#SubjectStructure)
+ [PropertygraphSummaryValueMap (estrutura)](#PropertygraphSummaryValueMap)
+ [PropertygraphSummary (estrutura)](#PropertygraphSummary)
## GetPropertygraphStatistics (ação)
O nome da CLI da AWS para essa API é: `get-propertygraph-statistics`.
Obtém estatísticas do grafo de propriedades (Gremlin e openCypher).
Ao invocar essa operação em um cluster do Neptune com a autenticação do IAM habilitada, o usuário ou o perfil do IAM que faz a solicitação deve ter uma política anexada que viabilize a ação do IAM [neptune-db:GetStatisticsStatus](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getstatisticsstatus) nesse cluster.
**Solicitação**
+ *Sem parâmetros de solicitação.*
**Resposta**
+ **payload** – *Obrigatório:* um objeto [Statistics](#Statistics).
Estatísticas para dados de grafos de propriedades.
+ **status**: *obrigatório:* uma string, do tipo: `string` (uma string codificada em UTF-8).
O código de retorno HTTP da solicitação. Se a solicitação for bem-sucedida, o código será 200. Consulte [Códigos de erro comuns para solicitação de estatísticas do DFE](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-dfe-statistics.html#neptune-dfe-statistics-errors) para obter uma lista de erros comuns.
**Erros**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [StatisticsNotAvailableException](data-api-dp-errors.md#StatisticsNotAvailableException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
## ManagePropertygraphStatistics (ação)
O nome da CLI da AWS para essa API é: `manage-propertygraph-statistics`.
Gerencia a geração e o uso de estatísticas de grafos de propriedades.
Ao invocar essa operação em um cluster do Neptune com a autenticação do IAM habilitada, o usuário ou o perfil do IAM que faz a solicitação deve ter uma política anexada que viabilize a ação do IAM [neptune-db:ManageStatistics](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#managestatistics) nesse cluster.
**Solicitação**
+ **mode** (na CLI: `--mode`): um StatisticsAutoGenerationMode, do tipo: `string` (uma string codificada em UTF-8).
O modo de geração de estatísticas. Um destes: `DISABLE_AUTOCOMPUTE`, `ENABLE_AUTOCOMPUTE` ou `REFRESH`, o último dos quais aciona manualmente a geração de estatísticas do DFE.
**Resposta**
+ **payload**: um objeto [RefreshStatisticsIdMap](#RefreshStatisticsIdMap).
É exibido apenas para o modo de atualização.
+ **status**: *obrigatório:* uma string, do tipo: `string` (uma string codificada em UTF-8).
O código de retorno HTTP da solicitação. Se a solicitação for bem-sucedida, o código será 200.
**Erros**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [StatisticsNotAvailableException](data-api-dp-errors.md#StatisticsNotAvailableException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
## DeletePropertygraphStatistics (ação)
O nome da CLI da AWS para essa API é: `delete-propertygraph-statistics`.
Exclui estatísticas dos dados (grafo de propriedades) do Gremlin e do openCypher.
Ao invocar essa operação em um cluster do Neptune com a autenticação do IAM habilitada, o usuário ou o perfil do IAM que faz a solicitação deve ter uma política anexada que viabilize a ação do IAM [neptune-db:DeleteStatistics](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#deletestatistics) nesse cluster.
**Solicitação**
+ *Sem parâmetros de solicitação.*
**Resposta**
+ **payload**: um objeto [DeleteStatisticsValueMap](#DeleteStatisticsValueMap).
A carga útil da exclusão.
+ **status**: uma string, do tipo: `string` (uma string codificada em UTF-8).
O status de cancelamento.
+ **statusCode**: um valor inteiro, do tipo: `integer` (um valor inteiro assinado de 32 bits).
O código de resposta HTTP: 200 se a exclusão for bem-sucedida ou 204 se não houver estatísticas para excluir.
**Erros**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [StatisticsNotAvailableException](data-api-dp-errors.md#StatisticsNotAvailableException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
## GetPropertygraphSummary (ação)
O nome da CLI da AWS para essa API é: `get-propertygraph-summary`.
Obtém um resumo de um grafo de propriedades.
Ao invocar essa operação em um cluster do Neptune com a autenticação do IAM habilitada, o usuário ou o perfil do IAM que faz a solicitação deve ter uma política anexada que viabilize a ação do IAM [neptune-db:GetGraphSummary](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getgraphsummary) nesse cluster.
**Solicitação**
+ **mode** (na CLI: `--mode`): um GraphSummaryType, do tipo: `string` (uma string codificada em UTF-8).
O modo pode assumir um dos dois valores: `BASIC` (o padrão) e `DETAILED`.
**Resposta**
+ **payload**: um objeto [PropertygraphSummaryValueMap](#PropertygraphSummaryValueMap).
Carga útil que contém a resposta resumida do grafo de propriedades.
+ **statusCode**: um valor inteiro, do tipo: `integer` (um valor inteiro assinado de 32 bits).
O código de retorno HTTP da solicitação. Se a solicitação for bem-sucedida, o código será 200.
**Erros**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [StatisticsNotAvailableException](data-api-dp-errors.md#StatisticsNotAvailableException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
## *Estruturas estatísticas:*
## Estatísticas (estrutura)
Contém informações estatísticas. O mecanismo DFE usa informações sobre os dados no grafo do Neptune para fazer compensações efetivas ao planejar a execução da consulta. Essas informações assumem a forma de estatísticas que incluem os chamados conjuntos de características e estatísticas de predicados que podem orientar o planejamento de consultas. Consulte [Gerenciar estatísticas a serem utilizadas pelo DFE do Neptune](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-dfe-statistics.html).
**Campos**
+ **active**: é um valor booliano, do tipo: `boolean` (um valor booliano (verdadeiro ou falso)).
Indica se a geração automática de estatísticas do DFE está ou não habilitada.
+ **autoCompute**: é um valor booliano, do tipo: `boolean` (um valor booliano (verdadeiro ou falso)).
Indica se a geração automática de estatísticas está habilitada ou não.
+ **date**: é um SyntheticTimestamp\$1date\$1time, do tipo: `string` (uma string codificada em UTF-8).
A hora UTC na qual as estatísticas do DFE foram geradas mais recentemente.
+ **note**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
Uma observação sobre problemas quando as estatísticas são inválidas.
+ **signatureInfo**: é um objeto [StatisticsSummary](#StatisticsSummary).
Uma estrutura StatisticsSummary que contém:
+ `signatureCount`: o número total de assinaturas em todos os conjuntos de características.
+ `instanceCount`: o número total de instâncias do conjunto de características.
+ `predicateCount`: o número total de predicados exclusivos.
+ **statisticsId**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
Relata o ID da execução atual da geração de estatísticas. Um valor de -1 indica que nenhuma estatística foi gerada.
## StatisticsSummary (estrutura)
Informações sobre os conjuntos de características gerados nas estatísticas.
**Campos**
+ **instanceCount**: é um valor inteiro, do tipo: `integer` (um valor inteiro assinado de 32 bits).
O número total de instâncias do conjunto de características.
+ **predicateCount**: é um valor inteiro, do tipo: `integer` (um valor inteiro assinado de 32 bits).
O número total de predicados exclusivos.
+ **signatureCount**: é um valor inteiro, do tipo: `integer` (um valor inteiro assinado de 32 bits).
O número total de assinaturas em todos os conjuntos de características.
## DeleteStatisticsValueMap (estrutura)
A carga útil de DeleteStatistics.
**Campos**
+ **active**: é um valor booliano, do tipo: `boolean` (um valor booliano (verdadeiro ou falso)).
O status atual das estatísticas.
+ **statisticsId**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
O ID da geração de estatísticas que está ocorrendo no momento.
## RefreshStatisticsIdMap (estrutura)
Estatísticas do modo `REFRESH`.
**Campos**
+ **statisticsId**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
O ID da geração de estatísticas que está ocorrendo no momento.
## NodeStructure (estrutura)
Uma estrutura de nó.
**Campos**
+ **count**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
Número de nós que têm essa estrutura específica.
+ **distinctOutgoingEdgeLabels**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
Uma lista de rótulos de borda de saída distintos presentes nessa estrutura específica.
+ **nodeProperties**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
Uma lista das propriedades dos nós presentes nessa estrutura específica.
## EdgeStructure (estrutura)
Uma estrutura de borda.
**Campos**
+ **count**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número de bordas que têm essa estrutura específica.
+ **edgeProperties**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
Uma lista das propriedades das bordas presentes nessa estrutura específica.
## SubjectStructure (estrutura)
Uma estrutura de assunto.
**Campos**
+ **count**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
Número de ocorrências dessa estrutura específica.
+ **predicates**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
Uma lista dos predicados presentes nessa estrutura específica.
## PropertygraphSummaryValueMap (estrutura)
Carga útil da resposta resumida do grafo de propriedades.
**Campos**
+ **graphSummary**: é um objeto [PropertygraphSummary](#PropertygraphSummary).
O resumo do grafo.
+ **lastStatisticsComputationTime**: é um SyntheticTimestamp\$1date\$1time, do tipo: `string` (uma string codificada em UTF-8).
A data e hora, no formato ISO 8601, da hora em que o Neptune calculou as estatísticas pela última vez.
+ **version**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
A versão dessa resposta de resumo do grafo.
## PropertygraphSummary (estrutura)
A API de resumo do grafo gera uma lista somente leitura de rótulos de nós e bordas e chaves de propriedade, junto com contagens de nós, bordas e propriedades. Consulte [Resposta do resumo de um grafo de propriedades (PG)](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-graph-summary.html#neptune-graph-summary-pg-response).
**Campos**
+ **edgeLabels**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
Uma lista de rótulos de bordas distintos no grafo.
+ **edgeProperties**: são objetos LongValuedMap. É uma matriz de mapa dos pares de chave-valor em que:
Cada chave é uma string, do tipo: `string` (uma string codificada em UTF-8).
Cada valor é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
Uma lista de propriedades de bordas distintas no grafo, junto com a contagem de bordas em que cada propriedade é usada.
+ **edgeStructures**: é uma matriz de objetos [EdgeStructure](#EdgeStructure).
Esse campo só está presente quando o modo solicitado é `DETAILED`. Ele contém uma lista de estruturas de bordas.
+ **nodeLabels**: é uma string, do tipo: `string` (uma string codificada em UTF-8).
Uma lista de rótulos de nós distintos no grafo.
+ **nodeProperties**: são objetos LongValuedMap. É uma matriz de mapa dos pares de chave-valor em que:
Cada chave é uma string, do tipo: `string` (uma string codificada em UTF-8).
Cada valor é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número de propriedades de nós distintas no grafo.
+ **nodeStructures**: é uma matriz de objetos [NodeStructure](#NodeStructure).
Esse campo só está presente quando o modo solicitado é `DETAILED`. Ele contém uma lista de estruturas de nós.
+ **numEdgeLabels**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número de rótulos de bordas distintos no grafo.
+ **numEdgeProperties**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número de propriedades de bordas distintas no grafo.
+ **numEdges**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número de bordas no grafo.
+ **numNodeLabels**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número de rótulos de nós distintos no grafo.
+ **numNodeProperties**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
Uma lista de propriedades de nós distintas no grafo, junto com a contagem de nós em que cada propriedade é usada.
+ **numNodes**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número de nós no grafo.
+ **totalEdgePropertyValues**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número total de usos de todas as propriedades de bordas.
+ **totalNodePropertyValues**: é um valor longo, do tipo: `long` (um valor inteiro assinado de 64 bits).
O número total de usos de todas as propriedades de nós.