Azure Digital Twins의 쿼리 단위Query Units in Azure Digital Twins

Azure Digital Twins 쿼리 단위 (QU)쿼리 API를 사용 하 여 azure digital twins 쿼리 를 실행 하는 데 사용 되는 주문형 계산 단위입니다.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.

Azure Digital Twins에서 지 원하는 쿼리 작업을 수행 하는 데 필요한 CPU, IOPS 및 메모리와 같은 시스템 리소스를 추상화 하 여 쿼리 단위 사용을 추적할 수 있습니다.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.

쿼리를 실행 하는 데 사용 되는 쿼리 단위의 크기는 다음의 영향을 받습니다.The amount of Query Units consumed to execute a query is affected by...

  • 쿼리의 복잡성the complexity of the query
  • 결과 집합의 크기 (결과 10 개를 반환 하는 쿼리는 하나의 결과만 반환 하는 비슷한 복잡성의 쿼리 보다 더 많은 QUs를 사용 함)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)

이 문서에서는 쿼리 단위를 이해 하 고 쿼리 단위 소비를 추적 하는 방법을 설명 합니다.This article explains how to understand Query Units and track Query Unit consumption.

Azure Digital Twins에서 쿼리 단위 소비 찾기Find the Query Unit consumption in Azure Digital Twins

Azure Digital Twins 쿼리 API를 사용 하 여 쿼리를 실행 하는 경우 응답 헤더를 검사 하 여 쿼리에 사용 된 QUs 수를 추적할 수 있습니다.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. Azure Digital Twins에서 다시 전송 된 응답에서 "쿼리 요금"을 찾습니다.Look for "query-charge" in the response sent back from Azure Digital Twins.

Azure Digital Twins sdk 를 사용 하면 페이징할 수 있는 응답에서 쿼리 요금 헤더를 추출할 수 있습니다.The Azure Digital Twins SDKs allow you to extract the query-charge header from the pageable response. 이 섹션에서는 디지털 쌍을 쿼리 하는 방법 및 페이징할 수 있는 응답을 반복 하 여 쿼리 요금 헤더를 추출 하는 방법을 보여 줍니다.This section shows how to query for digital twins and how to iterate over the pageable response to extract the query-charge header.

다음 코드 조각에서는 쿼리 API를 호출할 때 발생 하는 쿼리 요금을 추출 하는 방법을 보여 줍니다.The following code snippet demonstrates how you can extract the query charges incurred when calling the query API. 먼저 응답 페이지를 반복 하 여 쿼리 요금 헤더에 액세스 한 다음 각 페이지 내의 디지털 쌍 결과를 반복 합니다.It iterates over the response pages first to access the query-charge header, and then iterates over the digital twin results within each page.

다음 단계Next steps

Azure Digital Twins 쿼리에 대 한 자세한 내용은 다음을 참조 하세요.To learn more about querying Azure Digital Twins, visit:

Azure Digital Twins 쿼리 관련 한도는 참조: 서비스 제한으로 찾을 수 있습니다.You can find Azure Digital Twins query-related limits in Reference: Service limits.