Localizar o custo da unidade de pedido para as operações executadas no Azure Cosmos DB para Apache Cassandra

APLICA-SE A: Cassandra

O Azure Cosmos DB suporta muitas APIs, como SQL, MongoDB, Cassandra, Gremlin e Table. Cada API tem o seu próprio conjunto de operações de base de dados. Estas operações vão desde leituras e escritas simples a consultas complexas. Cada operação de base 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). O custo do pedido são as unidades de pedido consumidas por todas as operações da base de dados. Pode considerar as RUs como uma moeda de desempenho que abstrai os recursos do sistema, como CPU, IOPS e memória necessárias para realizar as operações de base de dados suportadas pelo Azure Cosmos DB. Independentemente da API que utiliza para interagir com o contentor do Azure Cosmos DB, os custos são sempre medidos pelas RUs. Quer a operação da base de dados seja uma escrita, leitura de ponto ou consulta, os custos são sempre medidos em RUs. Para saber mais, veja o artigo unidades de pedido e considerações .

Este artigo apresenta as diferentes formas de encontrar o consumo da unidade de pedido (RU) para qualquer operação executada num contentor no Azure Cosmos DB para Apache Cassandra. Se estiver a utilizar uma API diferente, veja API para MongoDB, API para NoSQL, API para Gremlin e API para artigos de Tabela para encontrar o custo de RU/s.

Quando efetua operações no Azure Cosmos DB para Apache Cassandra, o custo de RU é devolvido no payload de entrada como um campo chamado RequestCharge. Tem várias opções para obter os custos das RUs.

Utilizar um Controlador para Cassandra

Controlador .NET

Quando utiliza o SDK .NET, pode obter o payload de entrada na Info propriedade de um RowSet objeto:

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

Para obter mais informações, veja Início Rápido: Criar uma aplicação para Cassandra com o SDK .NET e o Azure Cosmos DB.

Controlador Java

Quando utiliza o SDK Java, pode obter o payload recebido ao chamar o getExecutionInfo() método num ResultSet objeto:

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

Para obter mais informações, veja Início Rápido: Criar uma aplicação para Cassandra com o SDK Java e o Azure Cosmos DB.

Controlador GOCQL

Quando utiliza o controlador GOCQL, pode obter o payload recebido ao chamar o GetCustomPayload() método num Iter tipo:

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 obter mais informações, veja Início Rápido: Criar uma aplicação para Cassandra com o GOCQL e o Azure Cosmos DB.

Passos seguintes

Para saber mais sobre como otimizar o consumo de RUs, veja estes artigos:

• Unidades de pedido e débito no Azure Cosmos DB
• Otimizar o débito aprovisionado no Azure Cosmos DB
• Otimizar o custo das consultas no Azure Cosmos DB