다음을 통해 공유


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의 현재 릴리스에 대해 알아봅니다.