Fabric アプリに関してよく寄せられる質問 (FAQ)

この記事では、Fabric Apps に関する一般的な質問に回答します。

General

Fabric Apps とは

Fabric Apps は、TypeScript 開発者がデータドリブン アプリケーションをより迅速に構築してデプロイするのに役立つバックエンド プラットフォームです。 TypeScript デコレーターを使用してデータ モデルを定義すると、Fabric Apps によって GraphQL API、データベース スキーマ、およびタイプ セーフ クライアントが自動的に生成されます。

Fabric Apps を使用する必要があるユーザー

Fabric アプリは、以下を構築する開発者に最適です。

  • 内部ツールとダッシュボード
  • データ探索と視覚化アプリケーション
  • 迅速なプロトタイプ
  • 永続的な状態を必要とする AI アプリケーションとエージェント アプリケーション

サポートされているデータベースは何ですか?

Fabric Apps は SQL Server をサポートします — Fabric のデプロイの既定です。

既存のデータベースで Fabric Apps を使用できますか?

No. Fabric Apps は、TypeScript データ モデルに基づいてデータベース スキーマを管理します。 定義済みのスキーマを持つ既存のデータベースを指すことはできません。

発達

CLI をインストールする方法

を使用して npm をインストールできます。 npm パッケージなので、 npm updateで更新できます。

npm i @microsoft/rayfin-cli

TypeScript を使用せずに Fabric Apps を使用できますか?

No. データ モデルは、TypeScript デコレーターを使用して定義する必要があります。 フロントエンド アプリケーションでは JavaScript を使用できますが、バックエンドではモデル定義に TypeScript が必要です。

どのようなフロントエンド フレームワークがサポートされていますか?

Fabric Apps は、HTTP 要求を行うことができるすべてのフロントエンド フレームワークで動作します。

  • React
  • Vue
  • Angular
  • Svelte
  • バニラ JavaScript/TypeScript

クライアント SDK は、すべてのフレームワークにタイプ セーフな API を提供します。

認証

どのような認証方法がサポートされていますか?

環境 サポートされているメソッド
Fabric を対象とするローカル フロントエンド Fabric ブローカーまたは委任されたトークン交換による Microsoft Entra へのサインイン。
ローカルバックエンド 開発用のメールアドレスとパスワード。
Fabric にデプロイ済み Fabric ポップアップ/iframe ハンドオフ、直接委任トークン交換、または外部親ホストを通じた Microsoft Entra サインイン。

Note

Fabricにデプロイした後、電子メールとパスワードの認証は機能しません。 認証が有効になっていない限り、アプリをFabricにデプロイすることはできません。

カスタム認証プロバイダーを使用できますか?

Fabric Apps は任意の ID プロバイダーをサポートしていません。 すでに委任されたMicrosoft Entraトークンを持っているアプリケーションは、ブラウザや Node.jsでsignInWithEntraToken()を使用できます。 このメソッドはカスタムプロバイダーではなく、別の Entra サインインパスを提供します。

services.auth.fabric.externalEntraExchangeを有効にし、アイテムの所有テナントで発行されたItem.Execute.Allで、展開のFabric/Power BIオーディエンス用に委任トークンを使用します。 また、ユーザーはアプリアイテムに対して 実行 権限が必要です。 このエクスチェンジはアプリ専用のサービスプリンシパルトークンをサポートしていません。 あなたのアイデンティティライブラリはトークン取得と同意を管理します。

サーバー側の統合では、ユーザーごとに別々のメモリ専用セッションを使用し、ユーザー間で可変の認証済みクライアントを共有しないことを心がけてください。 既存の Microsoft Entra トークンでサインインを参照してください。

外部ポータルは私のアプリを埋め込んでユーザーをサインインさせることはできますか?

Yes. 親は委任されたEntraトークンと正確なオリジン許可リストを使用して、createEmbedHost()から@microsoft/rayfin-embed-hostを使用できます。 外部 Entra 交換を有効にし、同じトークンおよびアイテム権限の前提条件を満たしてください。 iframeを読み込む前にホストを登録し、保存されたユーザーを復元する前にiframe内で initEmbeddedAuth() を待ちます。

ホストは iframe の原点と返元の原点を検証し、親の Entra トークンではなく、一度きりのハンドオフコードを渡します。 iframeを削除する際にホストを破棄してください。 「 外部親ポータルへの埋め込み」を参照してください。

デプロイメント

認証を有効にせずにアプリをデプロイできますか?

No. Fabricでは、Fabric アプリをデプロイする前に、fabric認証を有効にする必要があります。

複数の環境 (開発、ステージング、運用) にデプロイできますか?

Yes. デプロイメント パイプラインを使って、ワークスペース間で Fabric アプリを昇格します。 また、別々の Fabric ワークスペースを手動で管理し、異なるアイテムに展開することもできます。

Fabric Apps はアプリケーションライフサイクル管理(ALM)をサポートしていますか?

Yes. Fabric Apps は、バージョン管理のための Git 統合 と、環境間でアプリを昇格させるための 展開パイプライン をサポートしています。 概要については、「Microsoft Fabric における CI/CD」を参照してください。

デプロイにはどのくらいの時間がかかりますか?

通常、初期デプロイには 2 ~ 5 分かかります。 npx rayfin up staticapp deployを使用した後続のデプロイ (静的コンテンツのみ) には 30 ~ 60 秒かかります。

デプロイをロールバックできますか?

前の git コミットをチェックアウトし、 npx rayfin upを実行して、以前のバージョンを再デプロイします。

デプロイエラーをデバッグするにはどうすればよいですか?

  • ビルドエラー — npm run build をデプロイ前に実行します。 最も一般的なデプロイ エラーは、実稼働ビルドが見つからない場合です。 ビルドが成功したら、 npx rayfin upを実行します。
  • 容量または権限エラー — ワークスペースに Fabric 容量が割り当てられており、ワークスペース内でアイテムを作成または変更する権限があることを確認してください。
  • データベーススキーマエラー — データベーススキーマの適用中にエラーが発生した場合は、前回の成功した展開以降に行ったスキーマの変更を確認し、競合を解決してください。

データ モデル

複合主キーを使用できますか?

No. すべてのエンティティは、主キーとして id という名前の単一の UUID フィールドを使用する必要があります。

多対多リレーションシップはサポートされていますか?

No. 代わりに、2 つの @one() ナビゲーション デコレーターで明示的な結合エンティティを使用します。

カスタム SQL クエリを記述できますか?

Fabric Appsは生成されたAPIやコネクタを通じて生のカスタムSQLを公開しません。 アプリ所有データには生成されたGraphQLクライアントを使いましょう。 Fabric内の既存のレイクハウス、ウェアハウス、SQLデータベースにアクセスするには、コネクタを追加し、その型付き操作を使用します。

パフォーマンスとスケール

パフォーマンスの制限は何ですか?

パフォーマンスは、Fabric容量によって異なります。 容量固有の制限については、Fabric管理者にお問い合わせください。

クエリ結果をキャッシュできますか?

Yes. フロントエンド アプリケーションにクライアント側キャッシュを実装します。 バックエンドでは、組み込みのキャッシュは提供されません。

クエリのパフォーマンスを最適化する方法

  • 必要なフィールドのみを選択する
  • 大規模な結果セットにはページネーションを使用する
  • 複数の要求を行うのではなく、1 つのクエリに関連エンティティ フィールドを含める

セキュリティ

データはどのように保護されますか?

  • 既定では認証が必要です (エンティティごとに構成可能)
  • 行レベルのセキュリティ ポリシーは、JWT 要求に基づいてデータをフィルター処理します
  • すべての通信では、Fabricデプロイで HTTPS が使用されます

制限事項

現在の制限事項は何ですか?

  • Fluent GraphQLクライアントにはスタンドアロンの count() はありません。 数値フィールド aggregate() と groupBy()を使用するか、すべてのページにわたるレコードをカウントします。1ページ分のレコード数は、一致するレコードの合計ではありません。
  • 多対多リレーションシップはサポートされていません
  • 複合主キーはサポートされていません
  • カスタム認証プロバイダーはサポートされていません
  • 現時点ではワークスペースのアウトバウンドアクセス保護はサポートされていません。
  • 現時点ではテナントレベルおよびワークスペースレベルのプライベートリンクはサポートされていません。

回避策については、「Troubleshoot Fabric Apps を参照してください。

データをエクスポートできますか?

Yes. 生成されたデータクライアントを使ってアプリ所有データを読み込むか、コネクターを使ってサポートされているFabricデータ項目から読み取ることができます。 必要なフィールドだけを選択し、大きな結果セットをページングし、アプリケーション内でエクスポートを生成してください。