Microsoft Fabric Apps とは:概要と使い方
By Mirko Peters ·
Fabric Apps (preview) は、開発者が TypeScript を使って Microsoft Fabric 上にデータ駆動型のアプリを構築できる機能です。本ガイドでは、機能の概要、管理者による有効化の手順、アプリの作成と展開、アクセス許可、現時点の制限事項について説明します。
Automatically translated with AI from the original post. Read the English original
Fabric Apps は、データ駆動型のアプリケーションを構築するための Microsoft Fabric の機能で、現在プレビュー段階にあります。開発者は TypeScript でデータモデルを記述すると、Fabric がデータベース スキーマ、GraphQL API、サインイン、ホスティングを生成します。対象はレポート作成者ではなく開発者であり、Power BI アプリとは別の機能です。
重要なポイント
- Fabric Apps は Rayfin SDK 上に構築されたプレビュー機能です。開発者は TypeScript でデータモデルを定義し、Fabric がデータベース、GraphQL API、認証、ホスティングを生成します。
- テナント管理者は、まず Fabric 管理ポータルの [テナント設定] で Fabric Apps (preview) を有効にする必要があります。組織全体に対して有効にすることも、特定のセキュリティ グループに限定することもできます。
- ワークスペースには Fabric 容量を割り当てておく必要があります。Fabric Apps のサービスは、そこから容量ユニットを消費します。
- 展開後のサインインは、Microsoft Entra ID を介した Fabric SSO のみです。メールアドレスとパスワードは、ローカル開発でのみ使用できます。
- Microsoft は、多対多のリレーションシップ不可、複合キー不可、ALM 非対応、Private Link 非対応などの制限を挙げています。設計を確定する前に確認してください。
Fabric Apps の機能
Microsoft Learn では、Fabric Apps は Rayfin SDK 上に構築されると説明されています。TypeScript のクラスに、たとえば @entity()、@text()、@uuid() といったデコレーターを付与します。このモデルから、Fabric は次を生成します:
- データベース テーブル(マネージド ストアとして Fabric の SQL データベースを使用)
- アプリ バックエンドの URL 上の
/api/graphqlにある GraphQL エンドポイント @roleデコレーターによる行レベルの認可ルール- 型安全なクライアント メソッド
- フロントエンド用の静的ホスティング
rayfin up で展開すると、Fabric はアプリの下に子アイテムとして、Fabric の SQL データベース、Authentication、Static Content を作成します。各アプリには 1 つのバックエンド エンドポイントがあり、形式は https://<your-app>-app.rayfin.windows.net/ です。パスは、データ用の /api/graphql と、認証用の /auth です。
そのほかにドキュメントに記載されている機能として、レイクハウス、ウェアハウス、Fabric の SQL データベース、セマンティック モデルへの型付きコネクタや、アクセス ポリシーを備えた型付きファイル ストレージがあります。
適した用途
Microsoft は、次の用途に適しているとしています:迅速なプロトタイピング、社内ツールとダッシュボード、Fabric コネクタを使ったデータ探索、永続的な状態を必要とする AI やエージェント アプリ。一方で、次の用途には適さない可能性があるとしています:複雑な複数ステップのトランザクションやストアド プロシージャを必要とするアプリ、カスタム認証プロバイダーを必要とするアプリ。
手順 1:テナント設定を有効にする
これは管理者の作業であり、ユーザーがアイテムを作成できるようになる前に行う必要があります。
- Fabric 管理ポータルにサインインします。
- テナント設定を開きます。
- Fabric Apps (preview) で、トグルを 有効 に設定します。
- 組織全体、または特定のセキュリティ グループを選択します。
- 適用を選択します。
変更が反映されるまで数分かかる場合があります。
手順 2:ワークスペースを準備する
ワークスペースには Fabric 容量が割り当てられている必要があります。ワークスペースを作成するときに容量を選択してください。アプリを作成するには、そのワークスペースで共同作成者または管理者のアクセス許可が必要です。ローカルで作業する場合は、Node.js 20 以降をインストールしてください。
手順 3: アプリ アイテムを作成する
- 左側のナビゲーションで ワークスペース を選択し、対象のワークスペースを開きます。
- 新しいアイテム を選択し、App を検索して選択します。
- 名前を入力し、作成 を選択します。
ポータルに、プロジェクトをローカルにダウンロードするためのコマンドが表示されます。次のような形式です。
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
手順 4: 開発とデプロイ
プロジェクトを編集するか、GitHub Copilot を使って作業したうえで、npm run dev を実行して Fabric のバックエンドに対してテストします。npx rayfin up でデプロイします。別のワークスペースにデプロイするには、--workspace <workspacename> を追加します。バックエンドの状態は npx rayfin up status で確認できます。
FAQ の例のコメントでは、npx rayfin up staticapp deploy による静的コンテンツのみのデプロイは、初回デプロイの後に 30 秒から 60 秒かかるとされています。ただし、参照したページには初回デプロイの所要時間は記載されていません。静的コンテンツのみのデプロイでは初期のリモート アプリを作成できないため、先に npx rayfin up を一度実行してください。ロールバックするには、以前の git コミットをチェックアウトしてから、npx rayfin up を再度実行します。
Fabric ポータルで確認できる内容
rayfin up の実行後、アプリ アイテムには、rayfin.yml の構成から Fabric が作成した子アイテムが表示されます。
- Fabric の SQL データベース: デコレーターで定義したスキーマを持つマネージド データベースです。ポータルでは読み取り専用のため、スキーマの変更はコードで行ってください。
- 認証: Microsoft Entra ID を介して Fabric が仲介するサインインです。認証されたユーザーは SQL データベースで確認できます。
- Static Content: ビルド済みのフロントエンド アセットで、ホスティング URL から提供され、デプロイのたびに更新されます。概要によると、静的ホスティングでは Fabric アイテムへのアクセスが必要になる場合と、匿名アクセスを許可する場合があります。
認証とアクセス許可
Microsoft Learn では、デプロイ済みアプリには Fabric SSO、ローカル開発には電子メールとパスワードが挙げられています。電子メールとパスワードによるサインインはデプロイ後には機能せず、デプロイには Fabric 認証を有効にしておく必要があります。
アイテムのアクセス許可は、ワークスペースの役割とは別に管理されます。
| アクセス許可 | 許可される操作 | |---|---| | 実行と操作 | アプリを開いて利用し、バックエンド API を呼び出せます。既定では、ワークスペースのすべてのメンバーに付与されます。 | | 編集 (Write) | デプロイ、スキーマの変更、設定の更新、子サービスの管理 | | 再共有 | 他のユーザーにアクセスを付与します。ワークスペースの管理者の役割が必要です。 |
Fabric 管理者は、アプリの所有者は開けたままにしつつ、他のユーザーによるアプリの読み込みを一時的にブロックできます。
セキュリティの一部は利用者側の責任です。Microsoft は、シークレットをコードやフロントエンド アセットに含めないよう推奨しています。また、サインインしたユーザーが何を見て何をできるかは、あなたのコードが決めます。
事前に確認すべき制限事項
FAQ には、現時点での次の制限が挙げられています。
- 多対多のリレーションシップと複合主キーは使用できません(すべてのエンティティに
idという名前の単一の UUID フィールドが必要です) - カスタム認証プロバイダーは使用できません
- 標準では複数環境の管理機能はありません
- ワークスペースのアウトバウンド アクセス保護には対応していません
- テナントレベルおよびワークスペースレベルのプライベート リンクには対応していません
- アプリケーション ライフサイクル管理 (ALM) には対応していません
count()は fluent GraphQL クライアントでは使用できません
データ モデルは、デコレーターを使って TypeScript で記述します。
よくある問題
Microsoft は、ビルド エラーの最も一般的な原因として本番用ビルドの欠落を挙げています。そのため、まず npm run build を実行してください。容量またはアクセス許可のエラーが出た場合は、ワークスペースに容量があり、そこでアイテムを作成または変更できるかを確認します。スキーマのエラーが出た場合は、前回正常にデプロイされてからの変更内容を確認してください。トラブルシューティングのページでは、アプリのコードが信頼できる情報源であるとされています。既存の列を削除または変更すると、アプリとそのデプロイが壊れる可能性があるため、Fabric ポータルや SQL ツールからリモートのスキーマを変更しないでください。スキーマの変更はコードで行い、npx rayfin up db apply で適用してください。
関連情報
データソース
FAQ
Fabric Apps は一般提供されていますか?
いいえ。Microsoft Learn では、Fabric Apps はプレビュー機能とされており、まだすべてのリージョンで利用できないと説明されています。本記事で参照したページには、一般提供の日付は記載されていません。
Fabric アプリを作成できるのは誰ですか?
Microsoft Learn によると、Fabric 容量が割り当てられた Fabric ワークスペースで、共同作成者(Contributor)または管理者(Admin)のアクセス許可が必要です。また、テナント管理者が Fabric Apps (preview) のテナント設定を有効にしておく必要があります。ローカル開発には Node.js 20 以降が必要です。
展開された Fabric Apps はどのサインイン方法をサポートしていますか?
Microsoft Learn によると、展開されたアプリは Fabric SSO のみを使用します。Fabric SSO は Microsoft Entra のシングル サインオンです。メールアドレスとパスワードによるサインインはローカル開発でのみ利用でき、認証を有効にしないと展開できません。
Fabric アプリで既存のデータベースを使用できますか?
いいえ。Microsoft Learn の FAQ によると、Fabric Apps は TypeScript のモデルからスキーマを管理するため、事前定義されたスキーマを持つデータベースを指定することはできません。Fabric 内の既存のレイクハウス、ウェアハウス、SQL データベースに接続するには、コネクタを追加します。
Microsoft のページには Fabric Apps の価格が説明されていますか?
いいえ。参照したページには価格の記載がありません。概要では、ワークスペースに Fabric 容量が必要なことと、Fabric Apps のサービスがそこから容量ユニットを消費することのみが記載されています。また FAQ では、パフォーマンスは Fabric 容量に依存すると説明されています。