DTDL 스키마 관리
개요
이 화면은 무엇인가요?
이 화면에서는 DTDL 스키마 관리 데이터를 등록하고 관리합니다. 스키마유형(Interface, Component, Relationship 등)별로 분류할 수 있으며, 검증상태(valid → invalid → pending)를 추적합니다.
누가 사용하나요?
- IoT엔지니어: DTDL 스키마 정의, Azure 연동 설정
- 데이터분석가: 스키마 구조 확인, 데이터 모델 검증
언제 사용하나요?
- 트윈 모델의 표준 인터페이스를 DTDL로 정의할 때
- Azure Digital Twins 등 외부 플랫폼과 연동할 때
- 트윈 모델의 속성, 텔레메트리, 관계를 표준화할 때
주요 기능
- DTDL 스키마 정의: @context, @type, 속성, 텔레메트리, 관계 정의
- JSON-LD 편집: DTDL 스키마를 JSON-LD 형식으로 직접 편집
- 버전 관리: 스키마 버전별 이력 관리
- Azure 연동: DTDL 스키마를 Azure Digital Twins에 배포
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 설명 | 필수 | 입력 예시 |
|---|---|---|---|
| 스키마ID | 스키마ID | ✅ | 목록에서 선택 |
| 표시명 | 식별하기 쉬운 이름 | ✅ | (이름 입력) |
| DTDL버전 | DTDL버전 | ✅ | 2 / 3 |
| 스키마유형 | 분류 구분 | ✅ | Interface / Component / Relationship |
| DTDL콘텐츠 | DTDL콘텐츠 | ✅ | JSON 형식 입력 |
| 트윈모델ID | 관련 데이터 선택 | 목록에서 선택 | |
| 상위스키마ID | 관련 데이터 선택 | 목록에서 선택 | |
| 텔레메트리수 | 텔레메트리수 | 숫자 입력 | |
| 속성수 | 속성수 | 숫자 입력 | |
| 관계수 | 관계수 | 숫자 입력 | |
| 명령수 | 식별하기 쉬운 이름 | 숫자 입력 | |
| 검증상태 | 현재 진행 상태 | ✅ | valid / invalid / pending |
| 검증오류 | 검증오류 | JSON 형식 입력 | |
| 발행여부 | 발행여부 | 예 / 아니오 | |
| 발행일시 | 해당 날짜/시각 | 2026-03-17 09:00 | |
| 설명 | 식별하기 쉬운 이름 | 자유 텍스트 입력 | |
| 생성자ID | 담당자 선택 | 목록에서 선택 |
자주 묻는 질문 (FAQ)
DTDL이란 무엇인가요?
DTDL(Digital Twin Definition Language)은 Microsoft가 개발한 디지털 트윈 표준 스키마 언어입니다. JSON-LD 기반으로 트윈의 속성(Property), 텔레메트리(Telemetry), 관계(Relationship), 컴포넌트(Component)를 정의합니다.
실무 시나리오
DTDL 스키마 생성
상황: 로봇 설비의 DTDL 인터페이스를 정의합니다.
처리 순서:
- 스키마코드
DTDL-ROBOT-V1으로 생성합니다 - @context에 dtmi:dtdl:context;3을 입력합니다
- dtmiId에 트윈 모델의 DTDL ID를 입력합니다
- JSON-LD 형식으로 속성과 텔레메트리를 정의합니다
- 검증 후 배포합니다
참고: 데이터 구조
테이블: dt_dtdl_schemas
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
schema_id | 스키마ID | VARCHAR | *필수 |
display_name | 표시명 | VARCHAR | *필수 |
dtdl_version | DTDL버전 | 2 / 3 | *필수 |
schema_type | 스키마유형 | Interface / Component / Relationship | *필수 |
dtdl_content | DTDL콘텐츠 | JSONB | *필수 |
twin_model_id | 트윈모델ID | UUID | |
extends_schema_id | 상위스키마ID | UUID | |
telemetry_count | 텔레메트리수 | INT | |
property_count | 속성수 | INT | |
relationship_count | 관계수 | INT | |
command_count | 명령수 | INT | |
validation_status | 검증상태 | valid / invalid / pending | *필수 |
validation_errors | 검증오류 | JSONB | |
published | 발행여부 | BOOLEAN | |
published_at | 발행일시 | TIMESTAMP | |
description | 설명 | TEXT | |
created_by | 생성자ID | UUID |