Unidades de Consulta em Gémeos Digitais AzureQuery Units in Azure Digital Twins

A Azure Digital Twins Query Unit (QU) é uma unidade de computação a pedido que é usada para executar as suas consultas Azure Digital Twins utilizando a API de Consulta.An Azure Digital Twins Query Unit (QU) is a unit of on-demand computation that's used to execute your Azure Digital Twins queries using the Query API.

Retira os recursos do sistema como CPU, IOPS e memória que são necessários para realizar operações de consulta suportadas pela Azure Digital Twins, permitindo-lhe acompanhar o uso em Unidades de Consulta.It abstracts away the system resources like CPU, IOPS and memory that are required to perform query operations supported by Azure Digital Twins, allowing you to track usage in Query Units instead.

A quantidade de Unidades de Consulta consumidas para executar uma consulta é afetada por...The amount of Query Units consumed to execute a query is affected by...

  • a complexidade da consultathe complexity of the query
  • o tamanho do conjunto de resultados (de modo que uma consulta que devolva 10 resultados consumirá mais QUs do que uma consulta de complexidade semelhante que devolve apenas um resultado)the size of the result set (so a query returning 10 results will consume more QUs than a query of similar complexity that returns just one result)

Este artigo explica como compreender as Unidades de Consulta e acompanhar o consumo da Unidade de Consulta.This article explains how to understand Query Units and track Query Unit consumption.

Encontre o consumo da Unidade de Consulta em Gémeos Digitais AzureFind the Query Unit consumption in Azure Digital Twins

Quando fizer uma consulta utilizando a API de Consultade Gémeos Digitais Azure, pode examinar o cabeçalho de resposta para rastrear o número de QUs que a consulta consumiu.When you run a query using the Azure Digital Twins Query API, you can examine the response header to track the number of QUs that the query consumed. Procure "consulta-charge" na resposta enviada de Azure Digital Twins.Look for "query-charge" in the response sent back from Azure Digital Twins.

Os SDKs Azure Digital Twins permitem extrair o cabeçalho de carga de consulta da resposta pageable.The Azure Digital Twins SDKs allow you to extract the query-charge header from the pageable response. Esta secção mostra como consultar gémeos digitais e como iterar sobre a resposta pageable para extrair o cabeçalho de carga de consulta.This section shows how to query for digital twins and how to iterate over the pageable response to extract the query-charge header.

O seguinte corte de código demonstra como pode extrair as taxas de consulta incorridas ao ligar para a API de consulta.The following code snippet demonstrates how you can extract the query charges incurred when calling the query API. Itera-se primeiro nas páginas de resposta para aceder ao cabeçalho de carga de consulta e, em seguida, iterates sobre os resultados digitais gémeos em cada página.It iterates over the response pages first to access the query-charge header, and then iterates over the digital twin results within each page.

Passos seguintesNext steps

Para saber mais sobre a consulta das Gémeas Digitais Azure, visite:To learn more about querying Azure Digital Twins, visit:

Pode encontrar limites relacionados com a consulta Azure Digital Twins em Referência: Limitesde serviço .You can find Azure Digital Twins query-related limits in Reference: Service limits.