Azure Digital Twins サービスの制限

次のセクションでは、Azure Digital Twins のサービスの制限について説明します。

注意

このサービスの一部の領域には、調整可能な制限があります。 これは、次の表の 調整可能? 列に示されています。 制限が調整可能な場合、調整可能? の値は はい になります。

調整可能な制限を上げること、または既定の制限を超えたクォータが必要な場合は、サポート チケットを開いて追加のリソースを要求できます。

種類別の制限

機能制限

次の表に、Azure Digital Twins の機能制限の一覧を示します。

ヒント

これらの機能制限内で運用するためのモデリングの推奨事項については、「モデリングのベスト プラクティス」を参照してください。

領域 機能 既定の制限 調整可能?
Azure リソース 1 リージョン内の Azure Digital Twins インスタンスの数 (サブスクリプションごと) 10 はい
Digital Twins Azure Digital Twins インスタンス内のツインの数 200,000 はい
Digital Twins 1 つのツインに対する着信リレーションシップの数 5,000 いいえ
Digital Twins 1 つのツインからの発信リレーションシップの数 5,000 いいえ
Digital Twins 1 つのツインの最大サイズ (PUT または PATCH 要求の JSON 本文) 32 KB いいえ
Digital Twins 要求ペイロードの最大サイズ 32 KB いいえ
ルーティング 1 つの Azure Digital Twins インスタンスのエンドポイントの数 6 いいえ
ルーティング 1 つの Azure Digital Twins インスタンスのルート数 6 はい
モデル 1 つの Azure Digital Twins インスタンス内のモデルの数 10,000 はい
モデル 1 回の API 呼び出しでアップロードできるモデルの数 250 いいえ
モデル 1 つのモデルの最大サイズ (PUT または PATCH 要求の JSON 本文) 1 MB いいえ
モデル 1 つのページで返される項目の数 100 いいえ
クエリ 1 つのページで返される項目の数 100 はい
クエリ クエリ内の AND / OR 式の数 50 はい
クエリ IN / NOT IN 句内の配列項目の数 50 はい
クエリ クエリの文字数 8,000 はい
クエリ クエリ内の JOINS の数 5 はい

転送率の制限

次の表には、さまざまな API のレートの制限が示されています。

API 機能 既定の制限 調整可能?
モデル API 1 秒あたりの要求回数 100 はい
Digital Twins API 1 秒あたりの読み取り要求の数 1,000 はい
Digital Twins API 1 秒あたりのパッチ要求の数 1,000 はい
Digital Twins API すべてのツインとリレーションシップ における 1 秒あたりの作成/削除操作の数 50 はい
Digital Twins API 単一ツイン またはそのリレーションシップにおける 1 秒あたりの作成/更新/削除の操作の数 10 いいえ
クエリ 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 つの大きなグラフを作成するのではなく、ツインのサブセットをリージョンまたはテナントごとなどの、複数のインスタンスに論理的に分割することを検討してください。

次のステップ

Azure Digital Twins の最新リリースの詳細については、サービスの概要に関するページを参照してください。