この記事では、GraphQL 用 Microsoft Fabric API の現在の制限について詳しく説明します。
制限事項
Microsoft Fabric の GraphQL 用 API の現在の一般的な製品の制限事項については、この記事を参照してください。 新機能を使用して GraphQL 用 API を絶えず改善しています。 Microsoft Fabric の将来の詳細については、Fabric のロードマップに関する記事を参照してください。
SQL Analytics エンドポイントを利用してアクセスするデータ ソースは、それに対する読み取り操作のみをサポートします。 たとえば、変更は、Lakehouse やミラー化されたデータベースでは使用できません。
現在の既定のページ サイズは 100 です。つまり、すべての要求は応答で最大 100 個の要素を返します。 結果セットが100を超える場合は、GraphQL ページネーションを使用して結果を反復処理します。
ページネーションの最大サイズは 100,000 です。 つまり、要求が返す要素の最大数は固定されており、反復処理できます。 アプリケーションに対して 100,000 を超える要素を返す必要がある場合は、複数の要求を発行します。 このパターンは GraphQL では一般的ではないことを理解してください。
サポートされている最大応答サイズは 64 MB です。 つまり、応答サイズが 64 MB を超える API 要求ではエラーが返されます。 この制限を回避するには、フィルター処理された要求を複数発行します。
ストアド プロシージャの制限事項 (Azure SQL、Fabric の SQL Database、および Data Warehouse に適用):
- Api for GraphQL では、ストアド プロシージャによって返される最初の結果セットのみが使用されます。
- sys.dm_exec_describe_first_result_set によって記述された最初の結果セットのメタデータを持つストアド プロシージャのみがサポートされます。
- 構成ファイルと URL クエリ文字列の両方でストアド プロシージャ パラメーターを指定すると、URL クエリ文字列のパラメーターが優先されます。
- ストアド プロシージャによってサポートされるエンティティには、テーブルまたはビューによってサポートされるエンティティに対して自動的に提供されるすべての機能はありません。
- ストアド プロシージャでサポートされるエンティティは、改ページ、順序付け、またはフィルター処理をサポートしていません。 また、このようなエンティティでは、主キー値で指定されたアイテムの返しもサポートしていません。
要求のタイムアウトは現在 100 秒です。 つまり、完了までに 100 秒を超えるデータ ソース クエリを生成する要求を発行すると、要求が失敗してエラーが発生する可能性があります。
サポートされるクエリの最大深度は 10 です。 クエリの深さは、クエリ内のフィールドの入れ子レベルです。これは、潜在的な再帰や過剰なデータ フェッチが原因で、深すぎる場合にパフォーマンスに影響する可能性があります。
既知の問題
GraphQL 用 API の既知の問題については、Microsoft Fabric の既知の問題 参照してください。