Localizar o preço da unidade de solicitação para as operações executadas no Azure Cosmos DB for Apache Cassandra

APLICA-SE A: Cassandra

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 de pontos 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 do banco de dados é normalizado pelo Azure Cosmos DB e expresso por Unidades de Solicitação (ou RUs, abreviado na sigla em inglês). O preço da solicitação corresponde às unidades de solicitação consumidas por todas as operações de banco de dados. Você pode encarar as RUs como uma moeda de desempenho que abstrai os recursos do sistema (como CPU, IOPS e memória) necessários para executar as operações de banco de dados compatíveis com o Azure Cosmos DB. Independentemente da API usada para interagir com o contêiner do Azure Cosmos DB, os custos sempre serão medidos por RUs. Independentemente da operação de banco de dados ser uma gravação, uma leitura pontual ou uma consulta, os custos serão sempre medidos em RUs. Para saber mais, confira o artigo As unidades de solicitação e considerações sobre elas.

Este artigo apresenta as diferentes maneiras de localizar o consumo da RU (unidade de solicitação) para qualquer operação executada em um contêiner no Azure Cosmos DB for Apache Cassandra. Se você estiver usando uma API diferente, confira os artigos API para MongoDB, API para NoSQL, API para Gremlin e API de Tabela para localizar o preço de RUs.

Quando você executa operações no Azure Cosmos DB for Apache Cassandra, o preço de RU é retornado no conteúdo de entrada como um campo chamado RequestCharge. Você tem várias opções para recuperar o preço de RU.

Usar um Driver do Cassandra

Driver .NET

Ao usar o SDK do .NET, você pode recuperar o conteúdo de entrada na propriedade Info de um objeto RowSet:

RowSet rowSet = session.Execute("SELECT table_name FROM system_schema.tables;");
double requestCharge = BitConverter.ToDouble(rowSet.Info.IncomingPayload["RequestCharge"].Reverse().ToArray(), 0);

Para saber mais, consulte Início Rápido: Criar um aplicativo Cassandra usando o SDK do .NET e o Azure Cosmos DB.

Driver Java

Ao usar o SDK do Java, você pode recuperar o conteúdo de entrada chamando o método getExecutionInfo() em um objeto ResultSet:

ResultSet resultSet = session.execute("SELECT table_name FROM system_schema.tables;");
Double requestCharge = resultSet.getExecutionInfo().getIncomingPayload().get("RequestCharge").getDouble();

Para saber mais, consulte Início Rápido: Criar um aplicativo Cassandra usando o SDK do Java e o Azure Cosmos DB.

GOCQL Driver

Ao usar o driver do GOCQL, você pode recuperar o conteúdo de entrada chamando o método GetCustomPayload() em um tipo Iter:

query := session.Query(fmt.Sprintf("SELECT * FROM <keyspace.table> where <value> = ?", keyspace, table)).Bind(<value>)
iter := query.Iter()
requestCharge := iter.GetCustomPayload()["RequestCharge"]
requestChargeBits := binary.BigEndian.Uint64(requestCharge)
requestChargeValue := math.Float64frombits(requestChargeBits)
fmt.Printf("%v\n", requestChargeValue)

Para saber mais, consulte Início Rápido: Criar um aplicativo Cassandra usando o GOCQL e o Azure Cosmos DB.

Próximas etapas

Para saber mais sobre como otimizar o consumo de RU, confira estes artigos:

• Unidades de solicitação e taxa de transferência no Azure Cosmos DB
• Otimizar a taxa de transferência provisionada no Azure Cosmos DB
• Otimizar o custo de consulta no Azure Cosmos DB