Digital Twins 개체 모델 및 공간 인텔리전스 그래프 이해

중요

Azure Digital Twins 서비스의 새 버전이 릴리스되었습니다. 새 서비스의 확장된 기능에 비추어 원래 Azure Digital Twins 서비스(이 설명서 집합에 설명됨)가 사용 중지되었습니다.

새 서비스에 대한 설명서를 보려면 활성 Azure Digital Twins 설명서를 방문하세요.

Azure Digital Twins는 물리적 환경 및 환경과 연결된 디바이스, 센서, 사람의 포괄적인 가상 표현을 가능하게 해주는 Azure IoT 서비스입니다. 도메인별 개념을 유용한 모델로 구성하여 개발을 개선합니다. 그런 다음, 모델은 공간 인텔리전스 그래프 내의 배치합니다. 이러한 개념은 사람, 공간, 디바이스 간의 관계와 상호 작용을 정확하게 모델링합니다.

Digital Twins 개체 모델은 도메인별 개념, 범주 및 속성을 설명합니다. 모델은 특정 요구 사항에 맞게 솔루션을 조정하려는 사용자에 의해 미리 정의됩니다. 이러한 미리 정의된 Digital Twins 개체 모델은 온 로지로 구성됩니다. 스마트 건물의 온톨로지는 지역, 장소, 층, 사무실, 영역, 회의실 및 포커스 룸을 설명합니다. 에너지 그리드 온톨로지는 다양한 발전소, 변전소, 에너지 리소스 및 고객을 설명합니다. Digital Twins 개체 모델과 온톨로지를 통해 다양한 시나리오 및 요구 사항을 사용자 지정할 수 있습니다.

Digital Twins 개체 모델 및 온톨로지가 작동하면 공간 그래프를 채울 수 있습니다. 공간 그래프는 IoT 솔루션과 관련된 공간, 디바이스 및 사람 사이의 여러 관계를 가상으로 표현한 것입니다. 이 다이어그램은 스마트 건물의 온톨로지를 사용하는 공간 그래프의 예제를 보여줍니다.

Digital Twins 공간 그래프 빌드

공간 그래프는 공간, 디바이스, 센서 및 사용자를 하나로 합칩니다. 각각은 실제 세계를 모델링하는 방식으로 함께 연결됩니다. 이 샘플에서 장소 43은 4개의 층으로 구성되어 있으며 각각 다른 영역이 있습니다. 사용자는 자신의 워크스테이션과 연결되어 있고 그래프 일부에 대한 액세스 권한이 부여됩니다. 관리자는 공간 그래프를 변경하는 권한이 있는 반면 방문자는 특정 건물 데이터만 볼 수 있는 권한이 있습니다.

Digital Twins 개체 모델

Digital Twins 개체 모델은 다음과 같은 주요 범주를 지원합니다.

  • 공간 은 가상 또는 물리적 위치(예: Tenant, Customer, Region및)입니다 Venue.
  • 디바이스는 가상 또는 실제 장비입니다(예: AwesomeCompany DeviceRaspberry Pi 3).
  • 센서는 이벤트를 검색하는 개체입니다(예: AwesomeCompany Temperature SensorAwesomeCompany Presence Sensor).
  • 사용자는 점유자 및 점유자의 특징을 식별합니다.

그 외에도 다음과 같은 개체 범주가 있습니다.

  • 리소스는 공간에 연결되며 일반적으로 공간 그래프의 개체에서 사용할 Azure 리소스를 나타냅니다. 예를 들면 다음과 같습니다 IoTHub.
  • Blob은 개체(예: 공간, 디바이스, 센서 및 사용자)에 연결됩니다. mime 형식 및 메타데이터가 있는 파일로 사용됩니다(maps, picturesmanuals).
  • 확장 유형은 특정 특성을 사용하여 엔터티를 보강하는 확장 가능한 열거형입니다(예: SpaceTypeSpaceSubtype).
  • 온톨로지에서는 확장 형식 집합(예: Default, , BuildingBACnetEnergyGrid)을 나타냅니다.
  • 속성 키와 값 은 공간, 디바이스, 센서 및 사용자의 사용자 지정 특성입니다. 기본 제공 특성과 함께 사용할 수 있습니다. 예를 들어 키로 DeltaProcessingRefreshTime, 값으로 10을 사용합니다.
  • 역할은 공간 그래프의 사용자 및 디바이스에 할당된 사용 권한 집합(예: Space Administrator, User AdministratorDevice Administrator)입니다.
  • 역할 할당은 역할과 공간 그래프에서 역할과 개체 간의 연결입니다. 예를 들어, 사용자 또는 서비스 주체에 공간 그래프의 공간을 관리할 수 있는 권한이 부여될 수 있습니다.
  • 보안 키 저장소는 디바이스가 Digital Twins와 안전하게 통신할 수 있도록 특정 공간 개체 아래의 계층 구조에 있는 모든 디바이스를 위한 보안 키를 제공합니다.
  • 사용자 정의 함수(UDF)를 사용하면 공간 그래프 내에서 사용자 지정 가능한 센서 원격 분석 데이터를 처리할 수 있습니다. 예를 들어 UDF는 다음과 같은 작업을 수행할 수 있습니다.
    • 센서 값을 설정합니다.
    • 센서 판독값을 기반으로 하는 사용자 지정 논리를 수행하고 출력을 공간으로 설정합니다.
    • 공간에 메타데이터를 연결합니다.
    • 미리 정의된 조건이 충족되면 알림을 보냅니다. 현재 UDF는 JavaScript로 작성할 수 있습니다.
  • 검사기는 지정된 원격 분석 메시지에 대해 실행할 UDF를 결정하는 개체입니다.
  • Endpoints are the locations where telemetry messages and Digital Twins events can be routed, for example, Event Hub, Service Bus, and Event Grid.

공간 인텔리전스 그래프

공간 그래프는 Digital Twins 개체 모델에 정의된 공간, 디바이스 및 사람으로 구성되는 계층 그래프입니다. 공간 그래프는 상속, 필터링, 트래버스, 확장성 및 연장성을 지원합니다. REST API 컬렉션을 사용하여 공간 그래프를 관리하고 상호 작용할 수 있습니다.

구독에 Digital Twins 서비스를 배포하면 루트 노드의 글로벌 관리자가 됩니다. 그런 다음, 전체 구조에 대한 모든 액세스 권한이 자동으로 부여됩니다. Space API를 사용하여 그래프에 공간을 프로비저닝합니다. Sensor API를 사용하여 Device API 및 센서를 통해 서비스를 프로비저닝합니다. 오픈 소스 도구를 사용하여 그래프를 대량으로 프로비전할 수도 있습니다.

그래프 상속. 상속은 부모 노드에서 해당 부모 노드에 속한 모든 노드로 전달되는 권한 및 속성에 적용됩니다. 예를 들어 특정 노드의 사용자에게 역할이 할당되면 사용자는 지정된 노드와 해당 노드에 속한 모든 노드에 대한 해당 역할의 권한을 가지게 됩니다. 지정된 노드에 대해 정의된 각 속성 키 및 확장 유형은 해당 노드 아래에 있는 모든 노드에 상속됩니다.

그래프 필터링. 필터링은 요청 결과를 좁히는 데 사용됩니다. ID, 이름, 유형, 하위 유형, 부모 공간 및 연결된 공간별로 필터링할 수 있습니다. 센서 데이터 형식, 속성 키와 값, 트래버스, minLevel, maxLevel 및 기타 OData 필터 매개 변수를 기준으로 필터링할 수도 있습니다.

그래프 트래버싱. 해당 깊이와 너비를 통해 공간 그래프를 트래버스할 수 있습니다. 깊이의 경우 매개 변수인 트래버스, minLevelmaxLevel을 사용하여 그래프를 하향식 또는 상향식으로 트래버스할 수 있습니다. 그래프를 트래버스하여 형제 노드를 부모 공간 또는 너비에 대한 해당 하위 항목 중 하나에 직접 연결되도록 합니다. 개체를 쿼리할 때 GET API의 includes 매개 변수를 사용하여 해당 개체와 관계가 있는 모든 관련 개체를 가져올 수 있습니다.

그래프 확장성. Digital Twins는 그래프 확장성을 보장하므로 실제 워크로드를 처리할 수 있습니다. Digital Twins를 사용하여 부동산, 인프라, 디바이스, 센서, 원격 분석 등의 대규모 포트폴리오를 나타낼 수 있습니다.

그래프 확장성. 확장성을 사용하여 새 형식과 온톨로지로 기본 Digital Twins 개체 모델을 사용자 지정할 수 있습니다. 또한 확장 가능한 속성 및 값을 사용하여 Digital Twins의 데이터를 보강할 수 있습니다.

공간 인텔리전스 그래프 관리 API

Azure Portal에서 Digital Twins를 배포하면 관리 API의 Swagger URL이 자동으로 생성됩니다. 개요 섹션의 Azure Portal에 다음 형식으로 표시됩니다.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
이름 다음 항목으로 교체
YOUR_INSTANCE_NAME Digital Twins 인스턴스의 이름
YOUR_LOCATION 인스턴스를 호스팅하는 서버 지역

전체 URL 형식은 이 이미지에 표시됩니다.

Digital Twins 포털 관리 API

공간 인텔리전스 그래프를 사용하는 방법에 대한 자세한 내용은 Azure Digital Twins 관리 API 미리 보기를 방문하세요.

Swagger 미리 보기는 API 기능 집합을 설명하기 위해 제공됩니다. docs.westcentralus.azuresmartspaces.net/management/swagger에서 호스팅됩니다.

Swagger 사용 방법에 대해 자세히 알아보세요.

OAuth를 사용하여 모든 API 호출을 인증해야 합니다. API는 Microsoft REST API 지침 규칙을 따릅니다. 컬렉션을 반환하는 대부분의 API는 OData 시스템 쿼리 옵션을 지원합니다.

다음 단계