よくある GraphQL 用 Fabric API の質問に対する回答を見つけます。
GraphQL とは何か?
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 操作とは
GraphQL クエリ (読み取り) と変更 (書き込み) のみが現在サポートされています。 SQL Analytics エンドポイント経由で公開されるデータ ソースは読み取り専用であるため、クエリのみをサポートします。 Data Warehouse の場合は、変異を自動的に生成するために主キーを定義する必要があります。
GraphQL 用 Fabric API でリゾルバーを表示および編集するにはどうすればよいですか?
リゾルバーは、API のフィールドを解決し、データ ソースに存在するデータに対して操作を実行するビジネス ロジックを提供する GraphQL コンポーネントです。 新しいデータ ソースをアタッチするか、既存のデータ ソースから公開する新しいオブジェクトを選択するたびに、Fabric によってリゾルバーが自動的に生成されます。 現時点では、リゾルバーをカスタマイズすることはできません。 GraphQL 用 API でカスタマイズされたビジネス ロジックの場合は、データ ソースにストアド プロシージャを作成し、GraphQL API で公開できます。
GraphQL クライアント アプリケーションの API では、クエリや変更を実行するためにデータ ソースへのアクセスが必要ですか?
GraphQL 用 API では、アプリケーションで認証に Microsoft Entra ID を使用する必要があります。 Fabric に対して API 呼び出しを実行するには、クライアント アプリケーションを登録して適切に構成する必要があります。 Microsoft Entra に登録されているアプリには、Power BI サービス GraphQLApi.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 リージョンではサポートされていません。
GraphQL 用 API は Private Link をサポートしていますか?
現時点では、GraphQL 用 API では Private Link はサポートされていません。 ただし、今後この機能をサポートする予定であり、利用可能になると更新プログラムが提供される予定です。
Fabric テナントに対して Private Link を有効にしました。 GraphQL 項目が機能しないのはなぜですか?
テナント設定 "パブリック インターネット アクセスのブロック" が有効になっている (つまり、パブリック アクセスが無効になっている) 場合、サポートされていない成果物または項目 (GraphQL 用 API を含む) は自動的に無効になります。 つまり、以前に作成した項目にアクセスすることも、新しいアイテムを作成することもできません。 これらの項目にアクセスする唯一の方法は、パブリック アクセスを許可する方法です。
最初に発行した後、後続の要求に対して適切に実行した場合、要求のパフォーマンスが低下するのはなぜですか?
この動作には、主に 2 つの理由があります。 最初に、データ ソースがコールドである場合にウォームアップする必要がある場合、最初の要求に時間がかかる場合があります。 データ ソースがコールドでない場合でも、データ ソースに必要なデータがメモリに読み込まれていない場合、GraphQL が初めてクエリを発行する場合、データの取得は効率的ではない可能性があります。 2 つ目の理由は、GraphQL エンドポイント用 API への最初の要求に時間がかかる場合があります。これは、システムが要求を受け入れる準備を整えるためにスキーマと構成を読み込む必要があるためです。 これは 1 回限りのコストであり、システムは既にウォームアップされ、要求を処理する準備ができているため、後続の要求の方が高速です。
GraphQL 用 API に関するフィードバックや提案を提供するにはどうすればよいですか?
フィードバックとご提案をお待ちしております。 Fabric Ideasを通じてフィードバックを提供できます。 Microsoft のチームは、このプラットフォームを通じて送信されたフィードバックと提案を積極的に監視します。 また、特定のクエリや懸念事項については、Microsoft Fabric サポート 経由で Microsoft にお問い合わせください。