azure_digital_twins_query_request 플러그 인

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer

플러그 인은 azure_digital_twins_query_request KQL(Kusto 쿼리 언어) 쿼리의 일부로 Azure Digital Twins 쿼리를 실행합니다. 플러그 인은 연산자를 사용하여 호출됩니다 evaluate .

플러그 인을 사용하여 Azure Digital Twins와 KQL을 통해 액세스할 수 있는 모든 데이터 원본의 데이터를 쿼리할 수 있습니다. 예를 들어 시계열 분석을 수행할 수 있습니다.

플러그 인에 대한 자세한 내용은 Azure Digital Twins 쿼리 플러그 인을 참조하세요.

구문

evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름	Type	필수	설명
AdtInstanceEndpoint	string	✔️	쿼리할 Azure Digital Twins 인스턴스 엔드포인트입니다.
AdtQuery	string	✔️	Azure Digital Twins 엔드포인트에 대해 실행할 쿼리입니다. 이 쿼리는 Azure Digital Twins 쿼리 언어라고 하는 Azure Digital Twins에 대한 사용자 지정 SQL과 유사한 쿼리 언어로 작성됩니다. 자세한 내용은 Azure Digital Twins에 대한 쿼리 언어를 참조하세요.

인증 및 권한 부여

플러그 인은 azure_digital_twins_query_request 쿼리를 실행하는 사용자의 Microsoft Entra 계정을 사용하여 인증합니다. 쿼리를 실행하려면 사용자에게 Azure Digital Twins 데이터 판독기 역할을 부여해야 합니다. 이 역할을 할당하는 방법에 대한 정보는 Azure Digital Twins 솔루션에 대한 보안을 참조하세요.

예제

다음 예제에서는 추가 Kusto 식을 사용하는 쿼리를 포함하여 다양한 Azure Digital Twins 쿼리를 실행하는 방법을 보여 줍니다.

Azure Digital Twins 인스턴스 내의 모든 트윈 검색

다음 예제에서는 Azure Digital Twins 인스턴스 내의 모든 디지털 트윈을 반환합니다.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

추가 Kusto 식과 함께 열로 트윈 속성 프로젝션

다음 예제에서는 플러그 인의 결과를 별도의 열로 반환한 다음 Kusto 식을 사용하여 추가 작업을 수행합니다.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity

출력

TemperatureInC	습도
21	48
49	34
80	32

시계열 분석 수행

Azure Digital Twins의 데이터 기록 통합 기능을 사용하여 디지털 트윈 속성 업데이트를 히스토리화할 수 있습니다. 히스토화된 트윈 업데이트를 보는 방법을 알아보려면 히스토리화된 트윈 업데이트 보기를 참조 하세요.