Azure Digital Twins サービスの制限
次のセクションでは、Azure Digital Twins のサービスの制限について説明します。
Note
このサービスの一部の領域には、調整可能な制限があります。 これは、次の表の調整可能? 列に示されています。 制限が調整可能な場合、調整可能? の値ははいになります。
調整可能な制限を上げること、または既定の制限を超えたクォータが必要な場合は、サポート チケットを開いて追加のリソースを要求できます。
種類別の制限
機能制限
次の表に、Azure Digital Twins の機能制限の一覧を示します。
| 領域 | 機能 | 既定の制限 | 調整可能? |
|---|---|---|---|
| Azure リソース | 1 リージョン内の Azure Digital Twins インスタンスの数 (サブスクリプションごと) | 10 | はい |
| Digital Twins | Azure Digital Twins インスタンス内のツインの数 | 2,000,000 | はい |
| Digital Twins | 1 つの Import Jobs API ジョブでインポートできるデジタル ツインの数 | 2,000,000 | いいえ |
| Digital Twins | 1 つのツインに対する着信リレーションシップの数 | 50,000 | いいえ |
| Digital Twins | 1 つのツインからの発信リレーションシップの数 | 50,000 | いいえ |
| Digital Twins | Azure Digital Twins インスタンス内のリレーションシップの合計数 | 20,000,000 | はい |
| Digital Twins | 1 つの Import Jobs API ジョブでインポートできるリレーションシップの数 | 10,000,000 | いいえ |
| Digital Twins | 1 つのツインの最大サイズ (PUT または PATCH 要求の JSON 本文) | 32 KB | いいえ |
| Digital Twins | 要求ペイロードの最大サイズ | 32 KB | いいえ |
| Digital Twins | 文字列プロパティ値の最大サイズ (UTF-8) | 4 KB | いいえ |
| Digital Twins | プロパティ名の最大サイズ | 1 KB | いいえ |
| ルーティング | 1 つの Azure Digital Twins インスタンスのエンドポイントの数 | 6 | いいえ |
| ルーティング | 1 つの Azure Digital Twins インスタンスのルート数 | 6 | はい |
| モデル | 1 つの Azure Digital Twins インスタンス内のモデルの数 | 10,000 | はい |
| モデル | 1 つの API 呼び出し (Import Jobs API を使用しない) でインポートできるモデルの数 | 250 | いいえ |
| モデル | 1 つの Import Jobs API ジョブでインポートできるモデルの数 | 10,000 | いいえ |
| モデル | 1 つのモデルの最大サイズ (PUT または PATCH 要求の JSON 本文) | 1 MB | いいえ |
| モデル | 1 つのページで返される項目の数 | 100 | いいえ |
| クエリ | 1 つのページで返される項目の数 | 1000 | はい |
| クエリ | クエリ内の AND / OR 式の数 |
50 | はい |
| クエリ | IN / NOT IN 句内の配列項目の数 |
50 | はい |
| クエリ | クエリの文字数 | 8,000 | はい |
| クエリ | クエリ内の JOINS の数 |
5 | はい |
転送率の制限
次の表には、さまざまな API のレートの制限が示されています。
| API | 機能 | 既定の制限 | 調整可能? |
|---|---|---|---|
| ジョブ API | 1 秒あたりの要求回数 | 1 | はい |
| ジョブ API | 同時に実行されている一括ジョブの数 (インポートと削除を含む) | 1 | はい |
| モデル API | 1 秒あたりの要求回数 | 100 | はい |
| Digital Twins API | 1 秒あたりの読み取り要求の数 | 1,000 | はい |
| Digital Twins API | 1 秒あたりのパッチ要求の数 | 1,000 | はい |
| Digital Twins API | すべてのツインとリレーションシップにおける 1 秒あたりの作成/削除操作の数 | 500 | はい |
| Digital Twins API | 単一ツインまたはその着信と発信リレーションシップでの、1 秒あたりの作成、更新、削除の操作の数 | 10 | いいえ |
| Digital Twins API | 単一ツインまたはその着信と発信リレーションシップでの未処理操作の数 | 500 | いいえ |
| クエリ API | 1 秒あたりの要求回数 | 500 | はい |
| クエリ API | 1 秒あたりのクエリ単位数 | 4,000 | はい |
| イベント ルート API | 1 秒あたりの要求回数 | 100 | はい |
その他の制限
Azure Digital Twins モデルの DTDL ドキュメント内のデータ型とフィールドに関する制限事項については、GitHub の仕様ドキュメントを参照してください。Digital Twins Definition Language (DTDL) - バージョン 2。
クエリの待ち時間の詳細は、クエリ言語に関するセクションで説明しています。 クエリ言語の特定の機能の制約については、クエリの参考ドキュメントをご覧ください。
制限の使用
制限に達すると、制限を超える要求がサービスによって調整されます。これにより、これらの要求に対して 429 エラー応答が返されます。
スロットリングを管理するには、次の推奨事項に留意して制限を使用します。
- 再試行ロジックを使用します。 Azure Digital Twins SDK は、失敗した要求に対する再試行ロジックを実装しています。そのため、提供された SDK を使用している場合は、この機能が既に組み込まれています。 それ以外の場合は、使用しているアプリケーションに再試行ロジックを実装することを検討してください。 サービスは、失敗の応答で
Retry-Afterヘッダーを返送します。これを使用して、再試行までの待機時間を特定できます。 - しきい値と通知を使用して、制限に近づいていることを警告します。 Azure Digital Twins のサービスの制限には、対応するメトリックがあり、これを使用して、これらの領域での使用状況を追跡することができます。 しきい値を構成し、しきい値が近づいたときのメトリックに関するアラートを設定するには、警告ルールの作成に関するページにある手順を参照してください。 メトリックが提供されない他の制限の通知を設定するには、使用しているアプリケーションのコードにこのロジックを実装することを検討してください。
- 複数のインスタンスにわたって大規模にデプロイします。 単一障害点を回避する デプロイ全体に対して 1 つの大きなグラフを作成するのではなく、ツインのサブセットをリージョンまたはテナントごとなどの、複数のインスタンスに論理的に分割することを検討してください。
- これらの機能制限内で運用するために役立つモデリングの推奨事項については、モデリングのツールとベスト プラクティスに関する記事を参照してください。
Note
Azure Digital Twins では、この記事で説明されているレートの制限に合わせてリソースが自動的にスケーリングされます。 受信負荷に合わせて内部スケーリングを行うため、これらの制限に達する前に調整が発生する可能性があります。 内部スケーリングには 5 分から 30 分かかる場合があり、その間にアプリケーションで 429 エラーが発生することがあります。
次のステップ
Azure Digital Twins の最新リリースの詳細については、サービスの概要に関するページを参照してください。