적용 대상: ✅Microsoft Fabric✅Azure Data Explorer
플러그 인은 azure_digital_twins_query_request KQL(Kusto 쿼리 언어) 쿼리의 일부로 Azure Digital Twins 쿼리를 실행합니다. 플러그 인은 연산자를 사용하여 호출됩니다 evaluate .
플러그 인을 사용하여 Azure Digital Twins와 KQL을 통해 액세스할 수 있는 모든 데이터 원본의 데이터를 쿼리할 수 있습니다. 예를 들어 시계열 분석을 수행할 수 있습니다.
플러그 인에 대한 자세한 내용은 Azure Digital Twins 쿼리 플러그 인을 참조하세요.
구문
evaluate
azure_digital_twins_query_request
(
AdtInstanceEndpoint,AdtQuery)
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 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 솔루션에 대한 보안을 참조하세요.
예제
다음 예제에서는 Azure Digital Twins 인스턴스 내의 모든 디지털 트윈을 반환합니다.
evaluate azure_digital_twins_query_request(
'https://contoso.api.wcus.digitaltwins.azure.net',
'SELECT T AS Twins FROM DIGITALTWINS T')
다음 예제에서는 플러그 인의 결과를 별도의 열로 반환한 다음 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의 데이터 기록 통합 기능을 사용하여 디지털 트윈 속성 업데이트를 히스토리화할 수 있습니다. 히스토화된 트윈 업데이트를 보는 방법을 알아보려면 히스토리화된 트윈 업데이트 보기를 참조 하세요.