Limity usługi Azure Digital Twins

  • Artykuł

W poniższych sekcjach opisano limity usługi Azure Digital Twins.

Uwaga

Niektóre obszary tej usługi mają regulowane limity. Jest to reprezentowane w poniższych tabelach z kolumną Regulowane? Po dostosowaniu limitu można ustawić wartość Nastawna? ma wartość Tak.

Jeśli Twoja firma wymaga podniesienia regulowanego limitu lub limitu przydziału powyżej domyślnego limitu, możesz zażądać dodatkowych zasobów, otwierając bilet pomocy technicznej.

Limity według typu

Limity funkcjonalne

W poniższej tabeli wymieniono limity funkcjonalne usługi Azure Digital Twins.

Obszar Możliwość Limit domyślny Czy można dostosować?
Zasób platformy Azure Liczba wystąpień usługi Azure Digital Twins w regionie na subskrypcję 10 Tak
Digital Twins Liczba bliźniaczych reprezentacji w wystąpieniu usługi Azure Digital Twins 2,000,000 Tak
Digital Twins Liczba cyfrowych reprezentacji bliźniaczych, które można zaimportować w jednym zadaniu interfejsu API importu zadań 2,000,000 Nie.
Digital Twins Liczba relacji przychodzących do pojedynczej reprezentacji bliźniaczej 50,000 Nie.
Digital Twins Liczba relacji wychodzących z pojedynczej reprezentacji bliźniaczej 50,000 Nie.
Digital Twins Łączna liczba relacji w wystąpieniu usługi Azure Digital Twins 20,000,000 Tak
Digital Twins Liczba relacji, które można zaimportować w jednym zadaniu interfejsu API zadań importu 10,000,000 Nie.
Digital Twins Maksymalny rozmiar (treść JSON w żądaniu PUT lub PATCH) pojedynczej reprezentacji bliźniaczej 32 KB Nie.
Digital Twins Maksymalny rozmiar ładunku żądania 32 KB Nie.
Digital Twins Maksymalny rozmiar wartości właściwości ciągu (UTF-8) 4 KB Nie.
Digital Twins Maksymalny rozmiar nazwy właściwości 1 KB Nie.
Routing Liczba punktów końcowych pojedynczego wystąpienia usługi Azure Digital Twins 6 Nie.
Routing Liczba tras dla pojedynczego wystąpienia usługi Azure Digital Twins 6 Tak
Modele Liczba modeli w ramach pojedynczego wystąpienia usługi Azure Digital Twins 10,000 Tak
Modele Liczba modeli, które można zaimportować w jednym wywołaniu interfejsu API (nie przy użyciu interfejsu API importu zadań) 250 Nie.
Modele Liczba modeli, które można zaimportować w jednym zadaniu interfejsu API zadań importu 10,000 Nie.
Modele Maksymalny rozmiar (treść JSON w żądaniu PUT lub PATCH) pojedynczego modelu 1 MB Nie.
Modele Liczba elementów zwróconych na jednej stronie 100 Nie.
Query Liczba elementów zwróconych na jednej stronie 1000 Tak
Query AND / OR Liczba wyrażeń w zapytaniu 50 Tak
Query Liczba elementów tablicy w klauzuli IN / NOT IN 50 Tak
Query Liczba znaków w zapytaniu 8000 Tak
Query JOINS Liczba w zapytaniu 5 Tak

Limity szybkości

W poniższej tabeli przedstawiono limity szybkości różnych interfejsów API.

Interfejs API Możliwość Limit domyślny Czy można dostosować?
Interfejs API zadań Liczba żądań na sekundę 1 Tak
Interfejs API zadań Liczba zadań zbiorczych uruchomionych współbieżnie (w tym importowanie i usuwanie) 1 Tak
Interfejs API modeli Liczba żądań na sekundę 100 Tak
Digital Twins API Liczba żądań odczytu na sekundę 1000 Tak
Digital Twins API Liczba żądań poprawek na sekundę 1000 Tak
Digital Twins API Liczba operacji tworzenia/usuwania na sekundę we wszystkich reprezentacjach bliźniaczych i relacjach 500 Tak
Digital Twins API Liczba operacji tworzenia/aktualizowania/usuwania na sekundę w pojedynczej reprezentacji bliźniaczej lub relacjach przychodzących/wychodzących 10 Nie.
Digital Twins API Liczba zaległych operacji dla pojedynczej reprezentacji bliźniaczej lub relacji przychodzących/wychodzących 500 Nie.
Interfejs API zapytań Liczba żądań na sekundę 500 Tak
Interfejs API zapytań Jednostki zapytań na sekundę 4000 Tak
Interfejs API tras zdarzeń Liczba żądań na sekundę 100 Tak

Inne limity

Limity typów danych i pól w dokumentach DTDL dla modeli usługi Azure Digital Twins można znaleźć w dokumentacji specyfikacji w witrynie GitHub: Digital Twins Definition Language (DTDL) — wersja 2.

Szczegóły opóźnienia zapytań opisano w języku zapytań. Ograniczenia dotyczące określonych funkcji języka zapytań można znaleźć w dokumentacji referencyjnej zapytań.

Praca z limitami

Po osiągnięciu limitu wszystkie żądania wykraczające poza nią są ograniczane przez usługę, co spowoduje odpowiedź o błędzie 429 z tych żądań.

Aby zarządzać ograniczaniem przepustowości, poniżej przedstawiono kilka zaleceń dotyczących pracy z limitami.

  • Użyj logiki ponawiania prób. Zestawy SDK usługi Azure Digital Twins implementują logikę ponawiania prób dla żądań, więc jeśli pracujesz z dostarczonym zestawem SDK, ta funkcja jest już wbudowana. W przeciwnym razie rozważ zaimplementowanie logiki ponawiania prób we własnej aplikacji. Usługa wysyła z powrotem Retry-After nagłówek w odpowiedzi na awarię, którego można użyć do określenia, jak długo czekać przed ponowną próbą.
  • Użyj progów i powiadomień, aby ostrzec o zbliżaniu się do limitów. Niektóre limity usług dla usługi Azure Digital Twins mają odpowiednie metryki , których można użyć do śledzenia użycia w tych obszarach. Aby skonfigurować progi i skonfigurować alert dla dowolnej metryki po osiągnięciu progu, zobacz instrukcje w temacie Tworzenie nowej reguły alertu. Aby skonfigurować powiadomienia dla innych limitów, w których nie podano metryk, rozważ zaimplementowanie tej logiki we własnym kodzie aplikacji.
  • Wdrażanie na dużą skalę w wielu wystąpieniach. Unikaj posiadania pojedynczego punktu awarii. Zamiast jednego dużego grafu dla całego wdrożenia rozważ podział podzbiorów reprezentacji bliźniaczych logicznie (na przykład według regionu lub dzierżawy) w wielu wystąpieniach.
  • Aby uzyskać zalecenia dotyczące modelowania ułatwiające działanie w ramach limitów funkcjonalnych, zobacz Narzędzia modelowania i najlepsze rozwiązania.

Uwaga

Usługa Azure Digital Twins automatycznie skaluje zasoby w celu spełnienia limitów szybkości opisanych w tym artykule. Ograniczanie przepustowości może wystąpić przed osiągnięciem tych limitów z powodu wewnętrznego skalowania w celu dostosowania do obciążenia przychodzącego. Skalowanie wewnętrzne może potrwać od 5 do 30 minut, w tym czasie aplikacja może napotkać błędy 429.

Następne kroki

Dowiedz się więcej o bieżącej wersji usługi Azure Digital Twins w przeglądzie usługi: