よくある GraphQL 用 Fabric API の質問に対する回答を見つけます。
GraphQL とは何か?
GraphQL は、API 用のオープンソースのクエリ言語であり、既存のデータでそれらのクエリを実行するためのランタイムです。 GraphQL により、厳密に型指定されたシステムで API 内のデータの完全でわかりやすい説明が提供され、必要なものだけを厳密に要求する機能がクライアントに提供され、時間をかけて API を簡単に進化させることができ、強力な開発者ツールが可能になります。
GraphQL 用の Microsoft Fabric APIとは何か?
GraphQL 用 Microsoft Fabric API は、Microsoft Fabric Data Warehouse、Microsoft Fabric Lakehouse、Microsoft Fabric Mirrored Database、Microsoft Fabric SQL Database、Azure SQL Databases などのデータ ソースからデータにアクセスするための GraphQL API を数秒で作成できるようにする管理サービスです。 サポートされているこれらのデータ ソースからデータを照会および変更するための統合 API レイヤが提供されます。 GraphQL 用 Fabric API は現在プレビュー段階です。
GraphQL 用 Fabric API でサポートされている GraphQL 操作とは
GraphQL クエリ (読み取り) と変更 (書き込み) のみが現在サポートされています。 SQL Analytics エンドポイント経由で公開されるデータ ソースは読み取り専用であるため、クエリのみをサポートします。 Data Warehouse の場合は、変更を自動的に生成するために主キーを定義する必要があります。
GraphQL 用 Fabric API でリゾルバーを表示および編集するにはどうすればよいですか?
リゾルバーは、API のフィールドを解決し、データ ソースに存在するデータに対して操作を実行するビジネス ロジックを提供する GraphQL コンポーネントです。 新しいデータ ソースをアタッチするか、既存のデータ ソースから公開する新しいオブジェクトを選択するたびに、Fabric によってリゾルバーが自動的に生成されます。 現時点では、リゾルバーをカスタマイズすることはできません。 GraphQL 用 API でカスタマイズされたビジネス ロジックの場合は、データ ソースにストアド プロシージャを作成し、GraphQL API で公開できます。
GraphQL クライアント アプリケーションの API では、クエリや変更を実行するためにデータ ソースへのアクセスが必要ですか?
GraphQL 用 API では、アプリケーションの認証に Microsoft Entra を使用する必要があります。 Fabric に対して API 呼び出しを実行するには、クライアント アプリケーションを登録して適切に構成する必要があります。 Microsoft Entra 内に登録されているアプリには、Power BI サービスに対する Item.Execute.All アクセス許可が必要です。 詳細については、「Azure で Microsoft Entra アプリを作成する」を参照してください。 Microsoft Entra に加えて、API がシングル サインオン (SSO) を使用するように構成されている場合、GraphQL API を呼び出すアプリ内で認証されたユーザーまたはサービス プリンシパルには、GraphQL API とデータ ソースの両方へのアクセスが必要です。 具体的に、GraphQL API には "クエリと変更の実行" アクセス許可、選択したデータ ソースには適宜必要な読み取りまたは書き込みのアクセスです。 もう 1 つのオプションは、ユーザーまたはサービス プリンシパルを、API とデータ ソース項目の両方が配置されているワークスペースのメンバー ("共同作成者ロール" を持つ) にすることです。これにより、1 つの場所から両方の項目に必要なアクセスが提供されます。 詳しくは、ワークスペースへのアクセス権のユーザーへの付与に関する記事をご覧ください。 または、API が保存された資格情報を使用するように構成されている場合は、認証されたユーザーまたはサービス プリンシパルが API にアクセスできる必要があります (API に直接アクセス許可を追加する場合は、[クエリと変更 を実行する] オプションを選択します)。 ユーザー プリンシパルとサービス プリンシパルの両方のサンプル コードを含むエンドツーエンドの例は、アプリケーションを接続するを参照してください。
GraphQL 用 API のサポート チケットを開くにはどうすればいいですか?
GraphQL 用 Fabric API に関連する問題について Microsoft サポートの支援が必要な場合は、Fabric サポート サイトにアクセスし、[データ エンジニア] オプションを選択してください。
GraphQL 用 API でまだサポートされていないリージョンはどれですか?
GraphQL 用 API は現在、米国西部 3 Azure リージョンではサポートされていません。