Azure Digital Twins Explorer 사용(미리 보기)

Azure Digital Twins Explorer(미리 보기)는 Azure Digital Twins를 시각화하고 작업하기 위한 도구입니다. 이 문서에서는 Azure Digital Twins Explorer의 기능과 이를 사용하여 Azure Digital Twins 인스턴스의 데이터를 관리하는 방법을 설명합니다. 클릭 또는 바로 가기 키를 사용하여 Azure Digital Twins Explorer와 상호 작용할 수 있습니다.

액세스 방법

Azure Digital Twins Explorer에 액세스하는 주요 방법은 Azure Portal을 사용하는 것입니다.

Azure Digital Twins 인스턴스에 대해 Azure Digital Twins Explorer를 열려면 먼저 포털 검색 창에서 해당 이름을 검색하여 포털에서 인스턴스로 이동합니다.

그런 다음, Azure Digital Twins Explorer 열기(미리 보기) 단추를 선택합니다.

그러면 새 탭에서 Azure Digital Twins Explorer가 열립니다. Explorer를 처음 사용하는 경우 주요 기능을 요약한 환영 모달이 표시됩니다.

Azure Digital Twins Explorer는 인스턴스에 자동으로 연결할 수 있습니다. 그렇지 않은 경우 Azure Digital Twins URL을 지정하라는 다음 화면이 표시됩니다. (화면에 이 상자가 표시되지 않으면 Azure Digital Twins Explorer가 이미 이 단계를 자동으로 완료한 것입니다.)

이 상자가 보이면 필드에 https://를 입력하고 인스턴스의 호스트 이름을 입력합니다(포털의 인스턴스 개요 페이지에서 찾을 수 있음). 이러한 값은 모두 인스턴스 URL을 구성합니다. 저장을 선택하여 인스턴스에 연결합니다.

Important

Azure Digital Twins Explorer는 프라이빗 엔드포인트를 지원하지 않습니다. Private Link를 사용하여 공용 액세스를 비활성화하는 Azure Digital Twins 인스턴스와 함께 Azure Digital Twins Explorer를 사용하려는 경우 클라우드에서 Azure Digital Twins Explorer 코드베이스를 비공개로 배포할 수 있습니다. 이를 수행하는 방법에 대한 지침은 Azure Digital Twins Explorer: 클라우드에서 실행을 참조하세요.

앱 내에서 컨텍스트 전환

애플리케이션에 들어간 후에는 위쪽 도구 모음에서 인스턴스 이름을 선택하여 현재 탐색기에 연결된 인스턴스를 변경할 수도 있습니다.

이렇게 하면 Azure Digital Twins URL 모달이 표시됩니다. 여기서 https:// 접두사 뒤에 다른 Azure Digital Twins 인스턴스의 호스트 이름을 입력하여 해당 인스턴스에 연결할 수 있습니다.

참고 항목

현재 앱 내에서 컨텍스트를 전환하는 기능은 개인 MSA(Microsoft 계정)에 사용할 수 없습니다. MSA 사용자는 Azure Portal에서 선택한 인스턴스에서 탐색기에 액세스하거나 환경에 대한 직접 링크를 통해 특정 인스턴스에 연결할 수 있습니다.

Digital Twin 그래프 쿼리

쿼리 탐색기 패널을 사용하여 그래프에 대한 쿼리를 수행할 수 있습니다.

실행하려는 쿼리를 입력합니다. 쿼리를 여러 줄에 입력하려면 SHIFT + ENTER를 사용하여 새 줄을 쿼리 상자에 추가할 수 있습니다.

쿼리 실행 단추를 선택하여 트윈 그래프 패널에 쿼리 결과를 표시합니다.

참고 항목

결과에 하나 이상의 트윈이 포함된 경우에도 관계를 비롯한 쿼리 결과는 트윈 그래프 패널에서만 렌더링할 수 있습니다. Azure Digital Twins에서는 관계만 반환하는 쿼리가 가능하지만 Azure Digital Twins Explorer에서는 출력 패널을 사용해야만 관계를 볼 수 있습니다.

쿼리 결과 오버레이

패널의 콘텐츠를 새 쿼리 결과로 완전히 바꾸는 대신 현재 트윈 그래프 패널에 표시된 내용을 강조 표시하려면 쿼리를 실행하기 전에 오버레이 결과 상자를 선택할 수 있습니다.

현재 트윈 그래프 패널에 표시되지 않는 항목이 쿼리 결과에 포함되어 있으면 요소가 기존 보기에 추가됩니다.

쿼리 저장 및 다시 실행

쿼리를 브라우저의 로컬 스토리지에 저장하여 손쉽게 선택하고 다시 실행할 수 있습니다.

참고 항목

로컬 브라우저 스토리지는 저장된 쿼리를 저장한 브라우저 외에 다른 브라우저에서는 사용할 수 없음을 의미합니다. 그러한 쿼리는 로컬 스토리지를 지울 때까지 브라우저 스토리지에 무기한 유지됩니다.

쿼리를 저장하려면 쿼리 상자에 쿼리를 입력하고 패널의 오른쪽에 있는 저장 아이콘을 선택합니다. 대화 상자가 나타나면 저장된 쿼리에 대한 이름을 입력합니다.

쿼리가 저장되면 저장된 쿼리 드롭다운 메뉴에서 선택하여 손쉽게 다시 실행할 수 있습니다.

저장된 쿼리를 삭제하려면 저장된 쿼리 드롭다운 메뉴가 열릴 때 쿼리 이름 옆에 있는 X 아이콘을 선택합니다.

팁

더 큰 그래프의 경우 제한된 하위 집합만 쿼리한 다음, 필요에 따라 그래프의 나머지 부분을 로드하는 것이 좋습니다. 트윈 그래프 패널에서 트윈을 두 번 클릭하여 추가 관련 노드를 검색할 수 있습니다.

트윈 그래프 살펴보기

트윈 그래프 패널을 사용하면 인스턴스의 트윈 및 관계를 탐색할 수 있습니다.

이 패널을 사용하여 트윈 데이터를 탐색할 수 있습니다.

트윈 그래프 패널은 그래프 보기 환경을 사용자 지정할 수 있는 기능도 몇 가지 제공합니다.

• 트윈 표시 속성 변경
• 트윈 그래프 레이아웃 편집
• 트윈 그래프 확장 제어
• 트윈 그래프 요소 표시 및 숨기기
• 트윈 그래프 요소 필터링 및 강조 표시

트윈 데이터 탐색

쿼리 탐색기를 사용하여 쿼리를 실행하면 트윈 그래프 패널에 표시되는 쿼리 결과에 트윈 및 관계가 표시됩니다.

팁

모든 트윈 및 관계를 표시하는 쿼리는 SELECT * FROM digitaltwins입니다.

트윈 및 관계 속성 보기

트윈 또는 관계의 속성 값을 보려면 트윈 그래프에서 트윈 또는 관계를 선택하고 속성 검사기 설정/해제 단추를 사용하여 트윈 속성 또는 관계 속성 패널을 각각 펼칩니다. 이 패널에는 해당 값과 함께 요소와 연결된 모든 속성이 표시됩니다. 또한 아직 설정되지 않은 속성에 대한 기본값도 포함됩니다.

데이터 형식 아이콘

트윈 속성 및 관계 속성 패널에 표시된 속성은 각각 DTDL 모델의 필드 형식을 나타내는 아이콘과 함께 표시됩니다. 마우스로 아이콘 위를 가리키면 연결된 형식을 표시할 수 있습니다.

아래 표에서는 가능한 데이터 형식과 해당 아이콘을 보여 줍니다. 이 표에는 DTDL v3 언어 설명의 해당 스키마 설명에 대한 각 데이터 형식의 링크도 포함되어 있습니다.

Icon	데이터 형식
	boolean
	구성 요소
	date
	dateTime
	duration
	enum
	map
	double, float, integer 및 long을 포함한 숫자 형식
	object
	string
	time

Errors

트윈 또는 해당 속성 중 일부가 해당 모델과 더 이상 일치하지 않으면 트윈 속성 패널에 오류 메시지가 표시됩니다.

각각 고유한 오류 메시지를 제공하는 두 가지 가능한 오류 시나리오가 있습니다.

• 트윈에서 사용하는 하나 이상의 모델이 없습니다. 결과적으로 해당 모델과 연결된 모든 속성은 [트윈 속성] 패널에서 "missing"이라는 플래그가 지정됩니다. 트윈을 만든 이후 모델이 삭제된 경우 이 오류가 발생할 수 있습니다.
• 트윈의 일부 속성이 트윈 모델의 일부가 아닙니다. 이러한 속성만 트윈 속성 패널에서 "missing" 플래그가 지정됩니다. 속성이 설정된 이후 트윈에 대한 모델이 대체되거나 변경되었고 최신 버전의 모델에 해당 속성이 더 이상 없는 경우 이 오류가 발생할 수 있습니다.

이러한 오류 메시지는 모두 아래 스크린샷에 나와 있습니다.

기록된 속성의 유효성 검사 및 탐색

Azure Digital Twins 인스턴스에 데이터 기록이 사용하도록 설정되어 있는 경우 Azure Digital Twins Explorer에서 기록된 데이터의 유효성을 검사하고 탐색할 수 있습니다. 아래 단계에 따라 기록된 데이터를 차트로 시각화하거나 테이블에서 원시 값을 볼 수 있습니다.

1. 트윈 그래프 뷰어에서 보려는 기록 속성이 있는 트윈을 선택하여 트윈 속성 패널에서 엽니다. 패널의 오른쪽 상단에서 시계열 아이콘을 선택하여 데이터 기록 탐색기를 엽니다.

   

2. 왼쪽에서 트윈 이름을 선택하여 보려는 트윈의 과거 속성을 선택하는 옵션을 불러옵니다. 트윈 ID 필드는 트윈 선택으로 미리 채워집니다. 이 필드 옆에서 속성 검사 아이콘을 선택하여 트윈 데이터를 보거나 고급 트윈 검색 아이콘을 선택하여 속성 값을 쿼리하여 다른 트윈을 찾을 수 있습니다.

   

3. 속성 입력란에서 보려는 기록 데이터가 있는 속성을 선택합니다. 속성이 숫자가 아니지만 숫자 값으로 구성된 경우 속성 값을 숫자로 변환 옵션을 사용하여 이 데이터를 숫자로 변환하여 차트에서 시각화할 수 있습니다.

   

   참고 항목

   목록이 응답하지 않아 드롭다운 목록에서 속성을 선택할 수 없는 경우 인스턴스의 일부 모델에 오류가 있을 수 있습니다. 예를 들어 모델의 특성에 고유하지 않은 열거형 값이 있으면 이 기능이 중단됩니다. 이 경우 모델 정의를 검토하고 모든 속성이 유효한지 확인합니다.

4. 시계열의 레이블을 선택하고 업데이트를 선택합니다.

이렇게 하면 선택한 속성에 대해 기록된 값의 차트 보기가 로드됩니다. 차트 위의 탭을 사용하여 차트 보기와 표 보기 간에 전환할 수 있습니다.

시각화에 더 많은 속성을 추가하려면 왼쪽의 시계열 추가 단추를 사용합니다.

데이터 기록 탐색기를 종료하고 기본 Azure Digital Twins Explorer로 돌아가려면 닫기를 선택합니다.

차트에서 기록 보기

기록된 속성의 차트 보기는 시간 경과에 따라 속성 값을 꺾은선형 그래프의 점으로 표시합니다.

차트 위의 아이콘을 사용하여 다음을 포함한 차트 설정을 제어할 수 있습니다.

• 차트에 포함된 데이터의 시간 범위를 변경합니다.
• 여러 시계열을 독립적으로 표시할지 아니면 공유 y축에 표시할지 선택합니다. 축에 대해 독립을 선택하면 각 시계열이 차트에 맞게 크기 조정되고 자체 축을 유지합니다. 공유 축을 선택하면 모든 시계열 데이터가 동일한 축으로 조정됩니다.
• 차트의 집계 논리를 선택합니다. 속성에 차트에 표시할 수 있는 것보다 더 많은 데이터 포인트가 있는 경우 데이터는 평균, 최소 또는 최대 함수를 사용하여 한정된 양의 데이터 포인트로 집계됩니다.

Azure Data Explorer에서 쿼리 열기 단추도 있습니다. 여기에서 현재 쿼리를 보고 수정하여 시계열 데이터를 자세히 탐색할 수 있습니다.

표에서 기록 보기

기록된 속성의 표 보기는 속성 값과 해당 타임스탬프를 표로 보여 줍니다.

테이블 위에 있는 아이콘을 사용하여 다음을 포함한 테이블 설정을 제어할 수 있습니다.

• 테이블에 포함된 데이터의 시간 범위를 변경합니다.
• 독립적인 분석을 위해 테이블 데이터를 다운로드합니다.

트윈의 관계 보기

또한 특정 트윈(들어오고 나가는 관계 포함)을 포함하는 모든 관계의 코드를 빠르게 볼 수 있습니다.

그래프에서 마우스 오른쪽 단추로 트윈을 클릭하고, 관계 가져오기를 선택합니다. 이렇게 하면 모든 들어오고 나가는 관계의 JSON 표현을 표시하는 관계 정보 모달이 표시됩니다.

트윈 표시 속성 변경

트윈 그래프에서 트윈을 식별할 수 있도록 표시하려는 속성을 구성할 수 있습니다. 기본값은 $dtId 값이지만, 모델 세트에 있는 모든 속성(모든 트윈에 없는 속성도 포함)에서 선택할 수 있습니다.

표시 속성을 변경하려면 트윈 표시 이름 속성 선택 드롭다운 메뉴를 사용합니다. 드롭다운 메뉴는 속성이 포함된 모델의 수에 따라 정렬됩니다.

모든 트윈에 없는 속성을 선택하면 해당 속성이 없는 트윈이 별표(*) 뒤의 $dtId 값으로 그래프에 표시됩니다.

트윈 그래프 레이아웃 편집

트윈 그래프 화면에서 트윈을 클릭하여 끌어서 다른 구성으로 다시 정렬할 수 있습니다.

레이아웃 선택 메뉴의 옵션에서 여러 레이아웃 알고리즘 중 하나를 그래프에 적용할 수도 있습니다.

트윈 그래프 확장 제어

트윈 그래프 패널에서 쿼리 결과를 보는 동안 트윈을 두 번 클릭하면 그래프에서 해당 관계 및 관련 트윈을 페치할 수 있습니다. 보기에 아직 없으면 표시할 수도 있습니다. 크기와 방향을 설정하여 페치할 트윈의 수를 결정하여 이 확장을 사용자 지정할 수 있습니다.

확장할 레이어의 수를 설정하려면 확장 수준 옵션을 사용합니다. 이 숫자는 선택한 트윈에서 페치할 관계의 레이어 수를 나타냅니다.

확장할 때 따라야 하는 관계 유형을 나타내려면 확장 방향 단추를 사용합니다. 이렇게 하면 들어오는 관계, 나가는 관계 또는 두 관계 모두에서 선택할 수 있습니다.

트윈 그래프 요소 표시 및 숨기기

그래프 보기에서 트윈 또는 관계를 숨기는 옵션을 설정/해제할 수 있습니다.

트윈 또는 관계를 숨기려면 트윈 그래프 창에서 해당 항목을 마우스 오른쪽 단추로 클릭합니다. 이렇게 하면 요소 또는 기타 관련 요소를 숨길 수 있는 옵션이 있는 메뉴가 표시됩니다.

CTRL/CMD 또는 SHIFT 키를 사용하여 그래프에서 동일한 유형의 여러 요소를 다중 선택하여 여러 트윈 또는 관계를 한 번에 숨길 수도 있습니다. 지금부터 동일한 오른쪽 클릭 프로세스를 따라 숨기기 옵션을 볼 수 있습니다.

일부 항목을 숨긴 후 모든 트윈 표시로 돌아가려면 모두 표시 단추를 사용합니다. 모든 관계 표시로 돌아가려면 모든 관계 표시 단추를 사용합니다.

트윈 그래프 요소 필터링 및 강조 표시

이 필터 아이콘을 선택하여 그래프에 표시되는 트윈 및 관계를 텍스트로 필터링할 수 있습니다.

다음 강조 표시 아이콘을 선택하여 그래프에 표시되는 트윈 및 관계를 텍스트 기준으로 강조 표시할 수도 있습니다.

트윈 및 그래프 관리

Azure Digital Twins Explorer는 인스턴스의 트윈 및 관계를 관리하는 여러 가지 방법을 제공합니다.

이 섹션에서는 다음과 같은 관리 작업을 수행하는 방법을 설명합니다.

• 트윈 및 관계의 단순 목록 보기
• 초기 속성을 사용하거나 사용하지 않고 트윈 만들기
• 트윈 간에 관계 만들기
• 트윈 및 관계 속성 편집
• 트윈 및 관계 삭제

트윈 및 관계의 보기 환경에 대한 자세한 내용은 트윈 및 트윈 그래프 살펴보기를 참조하세요.

트윈 및 관계의 단순 목록 보기

트윈 패널에는 트윈 및 해당 연결된 관계의 단순 목록이 표시됩니다. 이름을 기준으로 트윈을 검색하고, 이를 확장하여 들어오고 나가는 관계에 대한 세부 정보를 볼 수 있습니다.

트윈 만들기

모델 패널의 모델 정의에서 새 디지털 트윈을 만들 수 있습니다.

모델에서 트윈을 만들려면 목록에서 해당 모델을 찾고 모델 이름 옆에 있는 메뉴 점을 선택합니다. 그런 다음, 트윈 만들기를 선택합니다. 새 트윈에 사용할 이름을 입력하라는 메시지가 표시됩니다. 이 이름은 고유해야 합니다. 그런 다음, 트윈을 저장하여 그래프에 추가합니다.

속성 값을 트윈에 추가하려면 트윈 및 관계 속성 편집을 참조하세요.

관계 만들기

두 트윈 간에 관계를 만들려면 트윈 그래프 창에서 관계에 대한 원본 트윈을 선택하는 것부터 시작합니다. 다음으로, CTRL/CMD 또는 SHIFT 키를 누른 상태에서 두 번째 트윈을 선택하여 관계의 대상으로 지정합니다.

두 트윈이 동시에 선택되면 대상 마우스 오른쪽 단추로 트윈을 클릭하여 둘 사이의 관계를 추가하는 옵션이 있는 메뉴를 표시합니다.

이렇게 하면 관계의 원본 트윈과 대상 트윈으로 채워진 관계 만들기 대화 상자가 표시됩니다(관계 교환 아이콘을 사용하여 전환할 수도 있음). DTDL 모델에 따라 원본 트윈이 가질 수 있는 관계 유형이 포함된 관계 드롭다운 메뉴가 있습니다. 관계 유형에 대한 옵션을 선택하고 새 관계를 저장합니다.

트윈 및 관계 속성 편집

트윈 또는 관계의 속성 값을 보려면 트윈 그래프에서 요소를 선택하고 속성 검사기 설정/해제 단추를 사용하여 트윈 속성 또는 관계 속성 패널을 각각 펼칩니다.

이 패널을 사용하여 쓰기 가능한 속성을 직접 편집할 수 있습니다. 값을 인라인으로 업데이트하고, 패널 위쪽에서 변경 내용 저장 단추를 선택하여 저장합니다. 업데이트를 저장하면 업데이트 API에서 적용한 JSON 패치 작업을 보여 주는 모달 창이 화면에 표시됩니다.

팁

트윈 속성 및 관계 속성 패널에 표시된 속성은 각각 DTDL 모델의 필드 형식을 나타내는 아이콘과 함께 표시됩니다. 형식 아이콘에 대한 자세한 내용은 데이터 형식 아이콘을 참조하세요.

트윈 및 관계 삭제

트윈 또는 관계를 삭제하려면 트윈 그래프 창에서 해당 항목을 마우스 오른쪽 단추로 클릭합니다. 이렇게 하면 요소를 삭제하는 옵션이 있는 메뉴가 표시됩니다.

CTRL/CMD 또는 SHIFT 키를 사용하여 그래프에서 동일한 유형의 여러 요소를 다중 선택하여 여러 개의 트윈이나 관계를 한 번에 삭제할 수도 있습니다. 지금부터 동일한 오른쪽 클릭 프로세스에 따라 요소를 삭제합니다.

위쪽의 도구 모음에 있는 모든 트윈 삭제 단추를 사용하여 인스턴스의 모든 트윈을 동시에 삭제하도록 선택할 수도 있습니다.

모델 및 모델 그래프 살펴보기

모델은 Azure Digital Twins Explorer 화면의 왼쪽에 있는 모델 패널과, 화면 중간의 모델 그래프 패널에서 볼 수 있습니다.

모델 패널:

모델 그래프 패널:

참고 항목

현재 Azure Digital Twins Explorer는 DTDL v2 모델을 완벽하게 지원하고 DTDL v3 모델에 대해 제한된 기능을 지원합니다.

DTDL v3 모델은 모델 패널에서 볼 수 있으며, DTDL v3 모델로 만들어진 트윈을 보고 편집할 수 있습니다(배열 속성이 있는 트윈 포함). 그러나 DTDL v3 모델은 모델 그래프 패널에 표시되지 않으며 Azure Digital Twins Explorer를 사용하여 가져올 수 없습니다. DTDL v3 모델을 인스턴스로 가져오려면 API, SDK 또는 Azure CLI와 같은 다른 개발자 인터페이스를사용합니다.

이러한 패널을 사용하여 모델을 볼 수 있습니다.

모델 그래프 패널은 그래프 보기 환경을 사용자 지정할 수 있는 기능도 몇 가지 제공합니다.

• 모델 그래프 레이아웃 편집
• 모델 그래프 요소 필터링 및 강조 표시
• 모델 이미지 업로드로 그래프에 모델 나타내기

모델 보기

모델 패널에서 인스턴스의 모델에 대한 단순 목록을 볼 수 있습니다. 이 목록은 패널의 검색 창을 사용하여 검색할 수 있습니다.

모델 그래프 패널을 사용하여 인스턴스의 모델에 대한 그래픽 표현과 모델을 서로 연결하는 관계, 상속 및 구성 요소를 볼 수 있습니다.

참고 항목

현재 Azure Digital Twins Explorer는 DTDL v2 모델을 완벽하게 지원하고 DTDL v3 모델에 대해 제한된 기능을 지원합니다.

DTDL v3 모델은 모델 패널에서 볼 수 있으며, DTDL v3 모델로 만들어진 트윈을 보고 편집할 수 있습니다(배열 속성이 있는 트윈 포함). 그러나 DTDL v3 모델은 모델 그래프 패널에 표시되지 않으며 Azure Digital Twins Explorer를 사용하여 가져올 수 없습니다. DTDL v3 모델을 인스턴스로 가져오려면 API, SDK 또는 Azure CLI와 같은 다른 개발자 인터페이스를사용합니다.

모델 정의 보기

모델에 대한 전체 정의를 보려면 모델 창에서 해당 모델을 찾아 모델 이름 옆에 있는 메뉴 점을 선택합니다. 그런 다음, 모델 보기를 선택합니다. 이렇게 하면 모델의 원시 DTDL 정의를 보여 주는 모델 정보 모달이 표시됩니다.

모델 그래프에서 모델을 선택하고 모델 세부 정보 설정/해제 단추를 사용하여 모델 세부 정보 패널을 확장함으로써 모델의 전체 정의를 볼 수도 있습니다. 이 패널에는 모델에 대한 전체 DTDL 코드도 표시됩니다.

모델 그래프 레이아웃 편집

모델 그래프 화면에서 모델을 클릭하여 끌어서 다른 구성으로 다시 정렬할 수 있습니다.

레이아웃 선택 메뉴의 옵션에서 여러 레이아웃 알고리즘 중 하나를 모델 그래프에 적용할 수도 있습니다.

모델 그래프 요소 필터링 및 강조 표시

모델 그래프에 나타나는 모델 참조 형식을 필터링할 수 있습니다. 이 메뉴의 스위치를 통해 참조 형식 중 하나를 끄면 해당 참조 형식이 그래프에 표시되지 않습니다.

이 필터 아이콘을 선택하여 그래프에 나타나는 모델 및 참조를 텍스트로 필터링할 수도 있습니다.

이 강조 표시 아이콘을 선택하여 텍스트로 그래프에 나타나는 모델 및 참조를 강조 표시할 수 있습니다.

모델 이미지 업로드

모델 그래프 및 트윈 그래프 보기에서 다른 모델을 나타내기 위해 사용자 지정 이미지를 업로드할 수 있습니다. 개별 모델을 업로드하거나 여러 개 모델을 한 번에 업로드할 수 있습니다.

참고 항목

이러한 이미지는 로컬 브라우저 스토리지에 저장됩니다. 즉, 이미지를 저장한 브라우저 외에 다른 브라우저에서는 사용할 수 없음을 의미합니다. 그러한 이미지는 로컬 스토리지를 지울 때까지 브라우저 스토리지에 무기한 유지됩니다.

단일 모델에 대한 이미지를 업로드하려면 모델 패널에서 해당 모델을 찾아 모델 이름 옆에 있는 메뉴 점을 선택합니다. 그런 다음, 모델 이미지 업로드를 선택합니다. 표시되는 파일 선택기 상자에서 사용자 컴퓨터에 있는 해당 모델에 대해 업로드할 이미지 파일로 이동합니다. 열기를 선택하여 업로드합니다.

모델 이미지를 대량으로 업로드할 수도 있습니다.

먼저 다음 지침을 사용하여 업로드하기 전에 이미지 파일 이름을 설정합니다. 이렇게 하면 업로드 후에 Azure Digital Twins Explorer에서 이미지를 올바른 모델에 자동으로 할당할 수 있습니다.

1. 모델 ID 값으로 시작합니다(예: dtmi:example:Floor;1).
2. “:”의 인스턴스를 “_”로 바꿉니다(이 예제에서는 dtmi_example_Floor;1).
3. “;”의 인스턴스를 “-”로 바꿉니다(이 예제에서는 dtmi_example_Floor-1).
4. 파일에 이미지 확장명이 있는지 확인합니다(이 예제에서는 dtmi_example_Floor-1.png).

참고 항목

위의 조건을 사용하여 기존 모델에 매핑되지 않는 이미지를 업로드하려고 하면 이미지가 업로드되지 않거나 저장되지 않습니다.

그런 다음, 이미지를 동시에 업로드하려면 모델 패널의 맨 위에 있는 모델 이미지 업로드 아이콘을 사용합니다. 파일 선택기 상자에서 업로드할 이미지 파일을 선택합니다.

모델 관리

Azure Digital Twins Explorer 화면의 왼쪽에 있는 모델 패널을 사용하여 전체 모델 세트 또는 개별 모델에서 관리 작업을 수행할 수 있습니다.

이 패널을 사용하여 다음 모델 관리 작업을 완료할 수 있습니다.

• Azure Digital Twins 인스턴스에 모델 업로드
• 인스턴스에서 모델 삭제
• 이 패널에 모든 모델 목록을 다시 로드하도록 모델 새로 고침

모델의 보기 환경에 대한 자세한 내용은 모델 및 모델 그래프 살펴보기를 참조하세요.

모델 업로드

모델 파일을 개별적으로 선택하거나 모델 파일의 전체 폴더를 한 번에 업로드하여 컴퓨터에서 모델을 업로드할 수 있습니다. 여러 모델에 대한 코드가 포함된 하나의 JSON 파일을 업로드하는 경우 대량 모델 업로드 제한 사항을 검토합니다.

참고 항목

현재 Azure Digital Twins Explorer는 DTDL v2 모델을 완벽하게 지원하고 DTDL v3 모델에 대해 제한된 기능을 지원합니다.

DTDL v3 모델은 모델 패널에서 볼 수 있으며, DTDL v3 모델로 만들어진 트윈을 보고 편집할 수 있습니다(배열 속성이 있는 트윈 포함). 그러나 DTDL v3 모델은 모델 그래프 패널에 표시되지 않으며 Azure Digital Twins Explorer를 사용하여 가져올 수 없습니다. DTDL v3 모델을 인스턴스로 가져오려면 API, SDK 또는 Azure CLI와 같은 다른 개발자 인터페이스를사용합니다.

개별적으로 선택된 하나 이상의 모델을 업로드하려면 위쪽 화살표를 표시하는 모델 업로드 아이콘을 선택합니다.

표시되는 파일 선택기 상자에서 사용자 컴퓨터에 있는 업로드할 모델로 이동합니다. 하나 이상의 JSON 모델 파일을 선택하고 열기를 선택하여 업로드할 수 있습니다.

모든 항목을 포함한 모델의 폴더를 업로드하려면 파일 폴더를 표시하는 모델의 디렉터리 업로드 아이콘을 선택합니다.

표시되는 파일 선택기 상자에서 사용자 컴퓨터에 있는 JSON 모델 파일이 포함된 폴더로 이동합니다. 열기를 선택하여 최상위 폴더와 모든 콘텐츠를 업로드합니다.

Important

관계 또는 구성 요소를 정의할 때와 같이 모델이 정의에서 다른 모델을 참조하는 경우 참조되는 모델이 인스턴스에 있어야 해당 모델을 사용하는 모델을 업로드할 수 있습니다. 모델을 하나씩 업로드하는 경우 이를 사용하는 모델을 업로드하기 전에 참조되는 모델을 업로드해야 합니다. 모델을 대량으로 업로드하는 경우 동일한 가져오기에서 모델 모두 선택할 수 있으며 Azure Digital Twins에서 업로드 순서를 유추합니다. 그러나 같은 파일에 50개가 넘는 모델을 업로드하는 경우 대량 모델 업로드 제한 사항을 참조하세요.

대량 모델 업로드의 제한 사항

이 섹션의 제한 사항은 동시에 Azure Digital Twins Explorer에 업로드되는 단일 JSON 파일 내에 포함된 모델에 적용됩니다.

단일 JSON 파일에 포함할 수 있는 모델 수에는 제한이 없지만 50개 이상의 모델이 포함된 파일에 대한 특별한 고려 사항이 있습니다. 동일한 모델 파일 내에서 50개 이상의 모델을 업로드하는 경우 다음 팁을 따릅니다.

• 동일한 파일에 정의된 다른 모델에서 상속되는 모델이 있는 경우 목록의 끝 부분에 배치합니다.
• 동일한 파일에 구성 요소로 정의된 다른 모델을 참조하는 모델이 있으면 목록의 끝 부분에 배치합니다.
• 모델이 동일한 파일에 정의된 다른 모델(상속을 통한 모델 또는 구성 요소와 같은 모델)을 참조할 때마다 참조를 포함하는 모델이 참조된 모델 정의보다 목록에서 나중에 오는지 확인합니다.

이렇게 하면 업로드 프로세스 중에 모델 종속성이 올바르게 해결되는지 확인하는 데 도움이 됩니다.

모델 삭제

모델 패널을 사용하여 개별 모델 또는 인스턴스의 모든 모델을 한 번에 삭제할 수 있습니다.

단일 모델을 삭제하려면 목록에서 해당 모델을 찾아 모델 이름 옆에 있는 메뉴 점을 선택합니다. 그런 다음, 모델 삭제를 선택합니다.

인스턴스의 모든 모델을 한 번에 삭제하려면 모델 패널 맨 위에 있는 모든 모델 삭제 아이콘을 선택합니다.

모델 새로 고침

Azure Digital Twins Explorer를 열면 모델 패널에 사용자 환경에서 사용 가능한 모든 모델이 자동으로 표시됩니다.

그러나 언제든지 패널을 수동으로 새로 고쳐 Azure Digital Twins 인스턴스의 모든 모델 목록을 다시 로드할 수 있습니다. 이렇게 하려면 모델 새로 고침 아이콘을 선택합니다.

그래프 가져오기/내보내기

트윈 그래프 패널에는 그래프 가져오기 및 내보내기 기능의 옵션이 있습니다.

그래프 가져오기

가져오기 기능을 사용하여 트윈, 관계 및 모델을 인스턴스에 추가할 수 있습니다. 이 기능은 많은 트윈, 관계 및/또는 모델을 한 번에 만드는 데 유용할 수 있습니다.

참고 항목

그래프 가져오기 파일에 모델이 포함되어 있으면 대량 모델 업로드 제한 사항이 적용됩니다.

가져오기 파일 만들기

그래프를 가져오는 첫 번째 단계는 추가하려는 트윈과 관계를 나타내는 파일을 만드는 것입니다.

가져오기 파일은 다음 두 가지 형식 중 하나일 수 있습니다.

• JSON 기반 형식은 그래프 내보내기에서 생성되며, 이 형식은 트윈, 관계 및/또는 모델을 포함할 수 있습니다.
• 사용자 지정 Excel 기반 형식은 이 섹션의 나머지 부분에서 설명하며, 이 형식을 사용하면 트윈 및 관계를 업로드할 수 있습니다.

Excel에서 가져오기 파일 만들기

트윈 및 관계를 Azure Digital Twins Explorer에 업로드할 수 있는 Excel에서 사용자 지정 그래프를 만들려면 다음 형식을 사용합니다.

각 행은 만들 요소를 나타냅니다. 트윈, 관계 또는 트윈과 해당 관계의 조합입니다. 다음 열을 사용하여 트윈 또는 관계 데이터를 구성합니다. 열 이름은 사용자 지정할 수 있지만 이 순서대로 유지되어야 합니다.

ModelID	ID	관계(원본)	관계 이름	Init 데이터
(선택 사항) 새 트윈에 사용할 모델의 DTMI ID입니다. 이 모델 정의는 인스턴스에 이미 있어야 합니다. 행이 트윈이 아닌 관계만 생성하도록 하려면 행에 대해 이 열을 비워 둘 수 있습니다.	(필수) 트윈의 고유 ID입니다. 새 트윈을 이 행에 만드는 경우 이 값은 새 트윈의 ID가 됩니다. 행에 관계 정보가 있는 경우 이 ID가 관계의 대상으로 사용됩니다.	(선택 사항) 새 관계의 원본 트윈이어야 하는 트윈의 ID입니다. 행이 관계가 아닌 트윈만 생성하도록 하려면 행에 대해 이 열을 비워 둘 수 있습니다.	(선택 사항) 만들 새 관계의 이름입니다. 관계 방향은 C열의 트윈에서 B열의 트윈까지입니다.	(선택 사항) 만들 트윈에 대한 속성 설정이 포함된 JSON 문자열입니다. 속성은 A 열의 모델에 정의된 속성과 일치해야 합니다.

다음은 2개의 층과 2개의 방이 있는 작은 그래프를 만드는 .xlsx 파일의 예제입니다.

이 파일 및 다른 .xlsx 그래프 예제는 GitHub의 Azure Digital Twins Explorer 리포지토리에서 볼 수 있습니다.

참고 항목

.xlsx에 설명된 속성 및 관계는 관련 트윈에 대한 모델 정의에 정의된 것과 일치해야 합니다.

Azure Digital Twins Explorer로 파일 가져오기

컴퓨터에 가져올 준비가 된 파일이 있으면 트윈 그래프 패널에서 그래프 가져오기 아이콘을 선택합니다.

표시되는 파일 선택기 상자에서 사용자 컴퓨터에 있는 업로드하려는 그래프 파일(.xlsx 또는 .json)로 이동하고 열기를 선택하여 업로드합니다.

Azure Digital Twins에서 가져올 그래프의 미리 보기를 보여 주는 가져오기 패널이 열립니다. 확인하려면 패널의 오른쪽 위 모서리에서 저장 아이콘을 선택합니다.

가져오기에 성공하면 모달 창에 업로드된 모델, 트윈 및 관계의 수가 표시됩니다.

그래프 및 모델 내보내기

내보내기 기능을 사용하여 모델, 트윈 및 관계를 포함한 부분 또는 전체 그래프를 내보낼 수 있습니다. 내보내기는 인스턴스의 모든 모델뿐만 아니라 가장 최근의 쿼리 결과의 트윈 및 관계를 컴퓨터에 다운로드할 수 있는 JSON 기반 형식으로 직렬화합니다.

시작하려면 쿼리 탐색기 패널을 사용하여 다운로드하려는 트윈 및 관계를 선택하는 쿼리를 실행합니다. 이렇게 하면 트윈 그래프 패널에 채워집니다.

팁

모든 트윈 및 관계를 표시하는 쿼리는 SELECT * FROM digitaltwins입니다.

트윈 그래프 패널에 다운로드하려는 그래프 부분이 표시되면 그래프 내보내기 아이콘을 선택합니다.

그러면 트윈 그래프 상자에서 다운로드 링크가 활성화됩니다. 이를 선택하여 쿼리 결과의 JSON 기반 표현과 인스턴스의 모든 모델을 사용자 컴퓨터에 다운로드합니다.

팁

가져오기 기능을 통해 이 파일을 편집하거나 Azure Digital Twins로 다시 업로드할 수 있습니다.

환경 및 특정 쿼리에 연결

Azure Digital Twins Explorer 환경에 대한 링크를 다른 사람과 공유하여 공동 작업할 수 있습니다. 이 섹션에서는 링크가 열릴 때 실행할 특정 쿼리를 선택적으로 포함할 수 있는 Azure Digital Twins Explorer 환경에 대한 링크를 생성하는 방법을 설명합니다. 이 섹션에서는 수신자가 트윈 데이터와 상호 작용하기 위해 필요한 권한도 설명합니다.

수신자 액세스 요구 사항

수신자가 링크를 열고 Azure Digital Twins Explorer에서 인스턴스를 보려면 Azure 계정에 로그인하고 인스턴스에 대한 Azure Digital Twins 데이터 읽기 권한자 액세스 권한이 있어야 합니다(Azure Digital Twins 역할에 대한 자세한 내용은 보안 참조).

수신자가 그래프 및 데이터를 변경하려면 인스턴스에 대한 Azure Digital Twins 데이터 소유자 역할이 있어야 합니다.

특정 쿼리로 환경에 대한 링크 생성

특정 쿼리를 포함하는 Azure Digital Twins Explorer 환경에 대한 링크를 생성하려면 쿼리 탐색기에 캡처할 쿼리를 입력한 다음 공유 단추를 선택하여 전체 링크를 복사합니다.

위 스크린샷의 예와 쿼리에서 공유 단추는 https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins%20T%20WHERE%20T.InFlow%20%3E%2070&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name> 링크를 생성합니다. 링크에는 Azure Digital Twins 인스턴스의 테넌트 ID 및 호스트 이름과 형식이 지정된 쿼리 텍스트가 포함되어 있습니다.

이 URL을 공유하여 다른 사람이 인스턴스 및 이 쿼리에 액세스할 수 있도록 할 수 있습니다. 링크를 사용하여 Azure Digital Twins Explorer를 열면 쿼리 결과가 트윈 그래프 패널에 자동으로 채워집니다.

특정 쿼리 없이 환경에 대한 링크 생성

특정 쿼리가 첨부되지 않은 Azure Digital Twins Explorer 환경에 대한 링크를 공유하려면 먼저 공유 단추를 사용하여 링크를 인스턴스에 복사합니다.

그런 다음 결과에서 쿼리 매개 변수를 수동으로 제거합니다.

예를 들어, 위 스크린샷의 공유 단추는 https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name> 링크를 생성합니다. query=SELECT%20*%20FROM%20digitaltwins& 부분을 제거하여 URL https://explorer.digitaltwins.azure.net/?tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>을 생성할 수 있습니다.

그런 다음 이 URL을 공유하여 다른 사람이 인스턴스에 액세스할 수 있도록 합니다. 링크를 사용하여 Azure Digital Twins Explorer를 열면 인스턴스에 연결되고 미리 채워진 쿼리 결과가 표시되지 않습니다.

접근성 및 고급 설정

Azure Digital Twins Explorer에 대한 몇 가지 고급 설정을 사용하도록 설정하여 환경을 사용자 지정하거나 접근성을 높일 수 있습니다.

오른쪽 위 도구 모음의 바로 가기 키 아이콘을 사용하여 Azure Digital Twins Explorer를 탐색하는 데 사용할 수 있는 바로 가기 키 목록을 볼 수 있습니다.

오른쪽 위 도구 모음의 [설정] 톱니 아이콘에는 액세스할 수 있는 몇 가지 고급 기능이 있습니다.

• 즉시 로드: 쿼리가 쿼리 결과에 포함되지 않은 다른 트윈과 관계가 있는 트윈을 반환하는 경우 이 기능은 그래프를 렌더링하기 전에 “누락된” 트윈을 로드합니다.
• 캐싱: 이 기능이 사용하도록 설정되면 Azure Digital Twins Explorer에서 관계 및 모델의 로컬 캐시를 메모리에 유지하여 쿼리 성능을 향상시킵니다. 이러한 캐시는 브라우저 새로 고침뿐만 아니라 관련 요소에 대한 쓰기 작업에서 지워집니다. 이 기능은 기본적으로 해제되어 있습니다.
• 콘솔: 이 기능을 사용하면 간단한 셸 함수를 그래프 작업에 사용할 수 있는 콘솔 창을 표시할 수 있습니다.
• 출력: 이 기능을 사용하면 작업의 진단 추적을 보여 주는 출력 창을 표시할 수 있습니다.
• 고대비: 이 기능은 더 뚜렷한 대비로 표시되도록 Azure Digital Twins Explorer의 색을 변경합니다.

Azure Digital Twins Explorer를 구성하는 패널의 위치(쿼리 탐색기, 모델, 트윈 그래프, 모델 그래프)를 편집하여 패널 레이아웃을 사용자 지정할 수 있습니다. 패널을 다른 위치로 이동하려면 패널 이름을 클릭하고 누른 상태로 원하는 새 위치로 끌어 놓습니다.

브라우저 창을 새로 고치면 패널 위치가 다시 설정됩니다.

다음 단계

Azure Digital Twins 트윈 그래프에 대한 쿼리 작성에 대해 알아봅니다.

• 쿼리 언어
• 쌍 그래프 쿼리