Azure Digital Twins 쿼리 언어
이 문서에서는 쿼리 언어 및 해당 기능에 대한 기본 사항을 설명합니다. Azure Digital Twins의 중심은 디지털 트윈과 관계로 생성된 트윈 그래프입니다. 이 그래프를 쿼리하여 포함된 디지털 트윈과 관계에 대한 정보를 확인할 수 있습니다. 이러한 쿼리는 Azure Digital Twins 쿼리 언어라고도 하는 SQL 같은 사용자 지정 쿼리 언어로 작성합니다. 이 언어는 많은 유사한 기능을 갖춘 IoT Hub 쿼리 언어와 비슷합니다.
쿼리 구문에 대한 자세한 예와 쿼리 요청을 실행하는 방법은 트윈 그래프 쿼리를 참조하세요.
쿼리 정보
Azure Digital Twins 쿼리 언어를 사용하여 다음에 따라 디지털 트윈을 검색할 수 있습니다.
- 속성(태그 속성 포함)
- 모델
- 관계
- 관계의 속성
클라이언트 앱에서 서비스로 쿼리를 제출하려면 Azure Digital Twins Query API를 사용합니다. API를 사용하는 한 가지 방법은 Azure Digital Twins용 SDK 중 하나를 사용하는 것입니다.
참조 설명서
쿼리 언어 참조는 Azure Digital Twins 설명서의 왼쪽 목차에 있는 참조에서 찾을 수 있습니다. 아래 링크를 사용하여 참조 섹션으로 직접 이동할 수도 있습니다.
쿼리 고려 사항
Azure Digital Twins에 대한 쿼리를 작성하는 경우 다음 고려 사항을 염두에 두어야 합니다.
대/소문자 구분: 모든 Azure Digital twins 쿼리 작업은 대/소문자를 구분하므로 모델에 정의된 정확한 이름을 사용해야 합니다. 속성 이름의 철자가 틀렸거나 대/소문자가 잘못된 경우에는 결과 집합이 비어 있고 오류가 반환되지 않습니다.
작은따옴표 이스케이프: 쿼리 텍스트에서 데이터에 작은따옴표 문자가 포함된 경우 따옴표를
\문자로 이스케이프해야 합니다. D'Souza의 속성 값을 처리하는 예는 다음과 같습니다.SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
참고 항목
그래프의 데이터를 변경한 후 변경 사항이 쿼리에 반영될 때까지 대기 시간은 최대 10초일 수 있습니다.
DigitalTwins API는 변경 사항을 즉시 반영하므로 즉각적인 응답이 필요한 경우 API 요청(DigitalTwins GetById)이나 SDK 호출(GetDigitalTwin)을 사용하여 쿼리 대신 트윈 데이터를 가져옵니다.
시간에 따라 기록된 트윈 데이터 쿼리
Azure Digital Twins 쿼리 언어는 디지털 트윈 및 관계의 현재 상태를 쿼리하기 위한 것입니다.
시간에 따라 수집되어 기록된 트윈 그래프 데이터에 대한 쿼리를 실행하려면 데이터 기록 기능을 사용하여 Azure Digital Twins 인스턴스를 Azure Data Explorer 클러스터에 연결합니다. 그러면 Azure Data Explorer 대한 그래프 업데이트가 자동으로 기록됩니다. 여기서 Azure Data Explorer에 대한 Azure Digital Twins 플러그 인을 사용하여 쿼리할 수 있습니다.
다음 단계
트윈 그래프 쿼리에서 쿼리를 작성하는 방법을 알아보고 클라이언트 코드 예를 확인하세요.