Limity usługi Azure Digital Twins
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-Afternagłó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: