Azure Digital Twins 서비스 제한
다음 섹션에서는 Azure Digital Twins의 서비스 제한에 대해 설명합니다.
참고 항목
이 서비스의 일부 영역에는 조정 가능한 한도가 있습니다. 이는 아래 표에 ‘조정 가능 여부’ 열과 함께 표시되어 있습니다. 제한을 조정할 수 있는 경우 조정 가능? 값은 예입니다.
비즈니스에서 조정 가능한 제한 또는 기본 제한보다 높은 할당량이 필요한 경우 지원 티켓을 열어 추가 리소스를 요청할 수 있습니다.
유형별 한도
기능 제한
다음 표에는 Azure Digital Twins의 기능 제한이 나와 있습니다.
| 지역 | 기능 | 기본 제한 | 조절이 가능한가요? |
|---|---|---|---|
| Azure 리소스 | 구독당 지역의 Azure Digital Twins 인스턴스 수 | 10 | 예 |
| Digital Twins | Azure Digital Twins 인스턴스의 트윈 수 | 2,000,000 | 예 |
| Digital Twins | 단일 가져오기 작업 API 작업에서 가져올 수 있는 디지털 트윈 수 | 2,000,000 | 아니요 |
| Digital Twins | 단일 쌍으로 들어오는 관계 수 | 50,000 | 아니요 |
| Digital Twins | 단일 쌍에서 나가는 관계 수 | 50,000 | 아니요 |
| Digital Twins | 총 Azure Digital Twins 인스턴스 관계 수 | 20,000,000 | 예 |
| Digital Twins | 단일 가져오기 작업 API 작업에서 가져올 수 있는 관계 수 | 10,000,000 | 아니요 |
| Digital Twins | 단일 쌍의 최대 크기(PUT 또는 PATCH 요청의 JSON 본문) | 32KB | 아니요 |
| Digital Twins | 최대 요청 페이로드 크기 | 32KB | 아니요 |
| Digital Twins | 문자열 속성 값의 최대 크기(UTF-8) | 4KB | 아니요 |
| Digital Twins | 속성 이름의 최대 크기 | 1KB | 아니요 |
| 라우팅 | 단일 Azure Digital Twins 인스턴스의 엔드포인트 수 | 6 | 아니요 |
| 라우팅 | 단일 Azure Digital Twins 인스턴스의 경로 수 | 6 | 예 |
| 모델 | 단일 Azure Digital Twins 인스턴스 내의 모델 수 | 10,000 | 예 |
| 모델 | 단일 API 호출에서 가져올 수 있는 모델 수(가져오기 작업 API를 사용하지 않음) | 250 | 아니요 |
| 모델 | 단일 가져오기 작업 API 작업에서 가져올 수 있는 모델 수 | 10,000 | 아니요 |
| 모델 | 단일 모델의 최대 크기(PUT 또는 PATCH 요청의 JSON 본문) | 1MB | 아니요 |
| 모델 | 단일 페이지에 반환된 항목 수 | 100 | 아니요 |
| 쿼리 | 단일 페이지에 반환된 항목 수 | 1000 | 예 |
| 쿼리 | 쿼리의 AND / OR 식 수 |
50 | 예 |
| 쿼리 | IN / NOT IN 절의 배열 항목 수 |
50 | 예 |
| 쿼리 | 쿼리의 문자 수 | 8,000 | 예 |
| 쿼리 | 쿼리의 JOINS 수 |
5 | 예 |
트래픽률 제한
다음 표에서는 다양한 API의 속도 제한을 반영합니다.
| API | 기능 | 기본 제한 | 조절이 가능한가요? |
|---|---|---|---|
| 작업 API | 초당 요청 수 | 1 | 예 |
| 작업 API | 동시에 실행되는 대량 작업 수(가져오기 및 삭제 포함) | 1 | 예 |
| 모델 API | 초당 요청 수 | 100 | 예 |
| Digital Twins API | 초당 읽기 요청 수 | 1,000 | 예 |
| Digital Twins API | 초당 패치 요청 수 | 1,000 | 예 |
| Digital Twins API | 모든 트윈 및 관계에서 초당 생성/삭제 작업 수 | 500 | 예 |
| Digital Twins API | 단일 쌍 또는 수신/발신 관계에 대한 초당 만들기/업데이트/삭제 작업 수 | 10 | 아니요 |
| Digital Twins API | 단일 쌍 또는 수신/발신 관계에 대한 미해결 작업 수 | 500 | 아니요 |
| 쿼리 API | 초당 요청 수 | 500 | 예 |
| 쿼리 API | 초당 쿼리 단위 | 4,000 | 예 |
| 이벤트 경로 API | 초당 요청 수 | 100 | 예 |
기타 제한
Azure Digital Twins 모델의 DTDL 문서 내에 있는 데이터 형식 및 필드에 대한 제한은 GitHub: DTDL(Digital Twins 정의 언어) - 버전 2의 사양 설명서 내에서 찾을 수 있습니다.
쿼리 대기 시간 세부 정보는 쿼리 언어에 설명되어 있습니다. 특정 쿼리 언어 기능의 제한 사항은 쿼리 참조 문서에서 확인할 수 있습니다.
제한 작업
제한에 도달하면 이를 넘어선 요청이 서비스에서 제한되므로 이러한 요청에서 429 오류 응답이 발생합니다.
제한을 관리하기 위해 제한 작업에 대한 몇 가지 권장 사항은 다음과 같습니다.
- 재시도 논리를 사용합니다. Azure Digital Twins SDK는 실패한 요청에 대한 재시도 논리를 구현하므로 제공된 SDK로 작업하는 경우 이 기능이 이미 기본 제공됩니다. 그렇지 않으면 자체 애플리케이션에서 재시도 논리를 구현하는 것이 좋습니다. 서비스는 다시 시도하기 전에 대기하는 시간을 결정하는 데 사용할 수 있는 오류 응답의
Retry-After헤더를 다시 보냅니다. - 임계값 및 알림을 사용하여 근접 한도에 대해 경고합니다. Azure Digital Twins에 대한 서비스 제한 중 일부에는 이러한 영역에서 사용량을 추적하는 데 사용할 수 있는 해당 메트릭이 있습니다. 임계값에 도달했을 때 임계값을 구성하고 메트릭에 대한 경고를 설정하려면 새 경고 규칙 만들기의 지침을 참조하세요. 메트릭이 제공되지 않는 기타 제한에 대한 알림을 설정하려면 고유한 애플리케이션 코드에서 이 논리를 구현하는 것이 좋습니다.
- 여러 인스턴스에 대규모로 배포합니다. 단일 실패 지점이 없으면 안 됩니다. 전체 배포에 대한 하나의 큰 그래프 대신 여러 인스턴스에서 트윈의 하위 집합을 논리적으로(예: 지역 또는 테넌트별) 분할하는 것이 좋습니다.
- 해당 기능 제한 내에서 작동할 수 있는 모델링 권장 사항은 모델링 도구 및 모범 사례를 참조하세요.
참고 항목
Azure Digital Twins는 이 문서에 설명된 속도 제한을 충족하도록 리소스의 크기를 자동으로 조정합니다. 들어오는 부하에 맞게 조정되는 내부 크기 조정으로 인해 이러한 제한에 도달하기 전에 제한이 발생할 수 있습니다. 내부 크기 조정은 5~30분 정도 걸릴 수 있으며, 이 기간 동안 애플리케이션에 429 오류가 발생할 수 있습니다.
다음 단계
서비스 개요에서 Azure Digital Twins의 현재 릴리스에 대해 알아봅니다.