Partilhar via


Encontre a taxa de unidade de solicitação para operações executadas no Azure Cosmos DB para Gremlin

APLICA-SE A: Gremlin

O Azure Cosmos DB dá suporte a muitas APIs, como SQL, MongoDB, Cassandra, Gremlin e Table. Cada API tem seu próprio conjunto de operações de banco de dados. Essas operações variam de simples leituras e gravações pontuais a consultas complexas. Cada operação de banco de dados consome recursos do sistema com base na complexidade da operação.

O custo de todas as operações de bases de dados é regulado pelo Azure Cosmos DB e é expresso por Unidades de Pedido (ou RUs, abreviatura em inglês). A taxa de solicitação é a unidade de solicitação consumida por todas as operações do banco de dados. Você pode pensar em RUs como uma moeda de desempenho abstraindo os recursos do sistema, como CPU, IOPS e memória, necessários para executar as operações de banco de dados com suporte do Azure Cosmos DB. Não interessa que API utiliza para interagir com o contentor do Azure Cosmos: os custos são sempre medidos por RUs. Seja a operação da base de dados de escrita, de leitura de ponto ou de consulta, os custos são sempre medidos em RU. Para saber mais, consulte as unidades de solicitação e seu artigo de considerações .

Este artigo apresenta as diferentes maneiras de encontrar o consumo de unidade de solicitação (RU) para qualquer operação executada em um contêiner no Azure Cosmos DB para Gremlin. Se você estiver usando uma API diferente, consulte os artigos API for MongoDB, Cassandra API, SQL API e Table API para localizar a cobrança de RU/s.

Os cabeçalhos retornados pela API Gremlin são mapeados para atributos de status personalizados, que atualmente são exibidos pelo Gremlin .NET e Java SDK. A taxa de solicitação está disponível sob a x-ms-request-charge chave. Ao usar a API Gremlin, você tem várias opções para localizar o consumo de RU para uma operação em um contêiner do Azure Cosmos.

Utilizar o portal do Azure

  1. Inicie sessão no portal do Azure.

  2. Crie uma nova conta do Azure Cosmos e alimente-a com dados ou selecione uma conta existente que já contenha dados.

  3. Vá para o painel Data Explorer e selecione o contêiner no qual deseja trabalhar.

  4. Insira uma consulta válida e selecione Executar consulta Gremlin.

  5. Selecione Estatísticas de consulta para exibir a cobrança de solicitação real para a solicitação executada.

Captura de tela para obter uma cobrança de solicitação de consulta Gremlin no portal do Azure

Usar o driver do SDK do .NET

Quando você usa o Gremlin.NET SDK, os StatusAttributes atributos de status estão disponíveis na propriedade do ResultSet<> objeto:

ResultSet<dynamic> results = client.SubmitAsync<dynamic>("g.V().count()").Result;
double requestCharge = (double)results.StatusAttributes["x-ms-request-charge"];

Para obter mais informações, consulte Guia de início rápido: criar um aplicativo .NET Framework ou Core usando uma conta do Azure Cosmos DB para Gremlin.

Usar o driver Java SDK

Ao usar o Gremlin Java SDK, você pode recuperar atributos de status chamando o statusAttributes() método no ResultSet objeto:

ResultSet results = client.submit("g.V().count()");
Double requestCharge = (Double)results.statusAttributes().get().get("x-ms-request-charge");

Para obter mais informações, consulte Guia de início rápido: criar um banco de dados gráfico no Azure Cosmos DB usando o Java SDK.

Próximos passos

Para saber mais sobre como otimizar seu consumo de RU, consulte estes artigos: