Microsoft Fabric の GraphQL 用 API の現在の一般的な製品の制限事項については、この記事を参照してください。 新機能を使用して GraphQL 用 API を継続的に改善しています。 Microsoft Fabric の将来の詳細については、Fabric のロードマップに関する記事を参照してください。
制限事項を理解する必要がある者
GraphQL API の制限事項を理解することは、次の場合に非常に重要です。
- Fabric GraphQL API 制約内で動作するアプリケーションを設計するアプリケーション開発者
- データ 公開戦略を 計画し、プラットフォームの境界を理解するデータ エンジニア
- ソリューション アーキテクトは、 ファブリック ベースのソリューションのスコープを設定し、適切な技術的な期待を設定します
- ファブリック ワークスペース共同作成者による 問題のトラブルシューティングと、現在の制限に対する回避策の実装
- プロジェクト計画中に ファブリック プラットフォームの制約を利害関係者に伝達するプロジェクト マネージャー
GraphQL API の実装を計画する場合や、予期しない API 動作のトラブルシューティングを行う場合は、これらの制限事項を確認してください。
データソース操作
SQL Analytics エンドポイントのデータ ソース では、読み取り操作のみがサポートされます。 SQL Analytics エンドポイント (Lakehouses やミラー化されたデータベースなど) を介してアクセスされるデータ ソースは、変更をサポートしていません。 データのクエリは実行できますが、GraphQL API を使用してレコードを作成、更新、または削除することはできません。
サイズとパフォーマンスの制限
次の表は、キー サイズ、改ページ位置、およびパフォーマンスの制約をまとめたものです。
| 制限の種類 | 価値 | Description | 対処法 |
|---|---|---|---|
| 既定のページ サイズ | 100 アイテム | 既定で要求ごとに返される最大アイテム数 | GraphQL ページネーションを使用して、より大きな結果セットを反復処理する |
| ページネーションサイズの最大設定 | 100,000 項目 | ページネーションを通じて取得できるアイテムの最大総数 | 100,000 個を超える項目が必要な場合は、複数のフィルター処理された要求を発行します (GraphQL では一般的でないパターン) |
| 最大応答サイズ | 64 MB | API 応答ペイロードの最大サイズ | フィルター処理された複数の要求を発行して、より小さなチャンク内のデータを取得する |
| 要求タイムアウト | 100 秒 | 1 つの要求の最大実行時間 | クエリを最適化するか、複雑な操作をより小さな要求に分割する |
| クエリの最大深度 | 10 レベル | クエリ内のフィールドの最大入れ子レベル | クエリの入れ子を減らして、過剰なデータフェッチによるパフォーマンスの問題を回避する |
ストアド プロシージャの制限事項
Azure SQL、Fabric の SQL Database、および Data Warehouse のストアド プロシージャには、特定の制約があります。
- 結果セットの処理: ストアド プロシージャによって返される最初の結果セットのみが使用されます。 複数の結果セットはサポートされていません。
-
メタデータ要件:
sys.dm_exec_describe_first_result_setで記述できる最初の結果セット メタデータを持つストアド プロシージャのみがサポートされます。 - パラメーターの優先順位: 構成ファイルと URL クエリ文字列の両方でストアド プロシージャ パラメーターが指定されている場合、URL クエリ文字列の値が優先されます。
-
制限付き GraphQL 機能: ストアド プロシージャによってサポートされるエンティティの機能は、テーブルまたはビューに基づくエンティティと比較して減少しています。
- ページネーションのサポートなし
- 順序付けまたはフィルター処理なし
- 主キーベースの検索なし
既知の問題
GraphQL 用 API の既知の問題については、Microsoft Fabric の既知の問題 参照してください。