Fabric アプリとは何ですか?

Fabric Apps は Rayfin SDK をベースに構築されており、開発者は統合開発ワークフローを用いて Fabric 上でデータ駆動型アプリケーションを作成できます。 開発者は TypeScript でデータ モデルを定義し、Fabric Apps は API を自動的に生成し、認証を処理し、ホスティングを提供し、Fabric サービスと統合します。 Fabric Apps では、データ モデル、クライアント コード、およびアプリケーション ロジックに対して TypeScript がサポートされます。 詳細については、 Rayfin SDK の概要を参照してください。

主要な機能

Fabric Apps には、次の機能があります。

  • データモデルからAPIへ – @entity()、@text()、@uuid()、その他のデコレーターでTypeScriptクラスをデコレートします。 Fabric Apps では、データベース スキーマと GraphQL エンドポイントが自動的に生成されます。
  • サーバー側の関数 - サーバー上でTypeScriptロジックを実行し、フロントエンドから型付きクライアント経由でそれを呼び出す。 アプリデータにアクセスし、シークレットを扱い、外部 API を呼び出します。 「Fabric アプリで関数を使用する」を参照してください。
  • コネクターを使って独自のデータを持ち込む - 既存のレイクハウス、ウェアハウス、Fabric の SQL データベース、またはセマンティックモデルへの型付きアクセスを追加します。 サポートされている操作はコネクタによって異なります。 「Fabric アプリを Fabric データに接続する」を参照してください。
  • ファイルストレージ - タイプ付きフォルダを定義し、認証ポリシーでアクセスを制御し、Fabricでファイルのアップロード、ダウンロード、リスト、削除を行います。 「 ファイルの保存と管理」をご覧ください。
  • 型安全クライアント – クライアントSDKは、バックエンドに到達する前にクエリやミューテーションを検証し、開発中にエラーを検出します。
  • 組み込み認証 – セッション管理、トークン処理、認証フローが組み込まれています。 デプロイされたアプリケーションのFabric SSO を構成するか、ローカル開発時に電子メールとパスワードを使用します。
  • 静的ホスティング – フロントエンドアプリケーションをバックエンドAPIとともに構築・提供します。 Fabricアイテムへのアクセスを義務付けるか、ホスト資産への匿名アクセスを許可してください。
  • 開発ワークフロー - スキャフォールドプロジェクトを組み立て、GitHub Copilot やその他のコーディングエージェントを使って開発し、Rayfin CLI を使って Fabric にデプロイします。 開発中は Fabric ベースのサービスを使用するか、サポートされているローカルサービスには Docker を使用してください。 ファイルストレージは、開発と展開の両方で Fabric ストレージを使用します。

サポートされているリージョン

リージョンの可用性については、「Fabric リージョンの可用性」を参照してください。

前提条件

ライセンスとワークスペース

ワークスペースの要件は、アプリのライセンスオプションによって異なります:

  • 容量バックアップ型アプリの場合、ワークスペースに Fabric 容量またはアクティブな Fabric トライアル容量を割り当てます。 アプリサービスはそのキャパシティからキャパシティ ユニットを使用します。
  • Power BI Pro のエクスペリエンスには、Pro ワークスペースを使用してください。 Fabric 容量を割り当てる必要はありません。 Power BI Pro の制限が適用されます。

ライセンス要件については、「Fabric Apps のライセンスオプションの選択」を参照してください。 どちらかのオプションでアプリを作成するには、「 ポータルからアプリを作成」に従ってください。

テナント管理者の設定

Fabric テナント管理者は、ユーザーがアイテムを作成する前に、Fabric Apps ワークロードを有効にする必要があります。

  1. Fabric 管理ポータルにサインインします。
  2. [テナント設定] に移動します。
  3. Fabric Appsの下で、設定を「有効」に切り替えます。
  4. 組織全体または特定のセキュリティ グループに対して有効にするかどうかを選択します。
  5. を選択してを適用します。

変更が反映されるまでに数分かかる場合があります。

どのように機能するのか

Fabric アプリはフロントエンドホスティングと管理されたバックエンドサービスを統合しています。 フロントエンドは Rayfin クライアントを使ってデータ API にアクセスし、関数を呼び出し、ファイルを管理し、接続されたデータのクエリを行います。 Fabricは、ホスティング、ネットワーク、スケーリングを管理します。 展開されたアプリはユーザー認証に Fabric SSO(Microsoft Entra ID シングルサインオン)を使用します。展開後は他のサインインプロバイダーは利用できません。

Fabricアプリ管理サービスとコンポーネントのスクリーンショットです。

Rayfin CLI を使用して展開すると、Fabric は rayfin.yml で有効になっているサービスをプロビジョニングまたは更新します。 アプリに必要なサービスを選択してください:

Service 提供される内容
データおよびGraphQL API Fabric の SQL データベース内の構造化アプリデータで、TypeScript データモデルや認可ルールから生成されるスキーマや API を利用できます。
Functions 呼び出し可能な HTTP エンドポイントを通じて公開されるサーバー側 TypeScript ロジックで、型付きクライアント呼び出しやアプリデータおよび外部サービスへのアクセスが可能です。
ファイルストレージ 文書、画像、添付ファイル向けの、型指定フォルダーと認証済みアクセス ルールを備えた OneLake を基盤とするストレージ。 ストレージはデータサービスが必要です。
Authentication デプロイ済みアプリ向けの Fabric SSO により、ユーザーは既存の Fabric ID でサインインできます。
静的ホスティング あなたが構築したフロントエンド ファイルはホスティング URL から提供され、静的コンテンツには保護されたアクセスまたは匿名アクセスでアクセスできます。

Fabric ポータルでの管理

デプロイ後、Fabric ポータルでFabric アプリを直接管理できます。

Fabric管理者は一時的に他のユーザーがあなたのアプリを読み込めないようにできます。 アプリの所有者として、あなたはまだアプリを開くことができます。 詳細は、「Fabric アプリのブロックとブロック解除」をご覧ください。

もしあなたがブロックされたアプリを所有または使用しているなら、「アプリがブロックされるとどうなるか」をご覧ください。

アイテムのアクセス許可

ワークスペース ロールは、アイテム レベルのアクセス許可よりも優先されません。 組織内のユーザーとアプリを共有するには、アプリを実行してバックエンド API を呼び出すために、 実行と対話 のアクセス許可 (読み取りと実行) が必要です。

許可 それが可能にする内容
実行して操作する(デフォルト) デプロイされたアプリケーションを開いて使用します。 既定では、すべてのワークスペース メンバーがこのレベルを受け取ります。
編集(書き込み) Fabric アプリを変更します。rayfin up を使用してコードをデプロイし、スキーマの変更を適用し、設定を更新し、子サービスを管理します。
再共有 他のユーザーにFabric アプリへのアクセス権を付与します。 ワークスペースの 管理者 ロールが必要です。

ワークスペースロールの詳細を確認します。

共有ワークフロー、関連するアイテムのアクセス許可、およびアクセス要求については、Fabric アプリを共有するを参照してください。

Rayfin CLI を使用した開発

CLI は新しいプロジェクトをスキャフォールディングし、ローカル インフラストラクチャを起動し、スキーマの変更を同期して、Fabricにデプロイします。 npm create @microsoft/rayfin@latestと共にインストールします。

主なコマンド:

命令 Purpose
npm create @microsoft/rayfin@latest テンプレートから新しいプロジェクトを作成します。
npx rayfin up プロジェクトをFabricに配置します。
npx rayfin up db apply データベース スキーマの変更を適用します。

完全なコマンド リファレンスについては、 CLI リファレンスを参照してください。

データ モデル デコレーター

TypeScript デコレーターを使用してデータ モデルを定義します。

デフォルトのスキャフォールド blankapp は Universal App Workspace です。 データはオプトイン方式です。packages/data/src/ にエンティティを追加する前に有効にし、クライアント向け契約は packages/shared/src/ に保持してください。 フラットテンプレートは代わりに rayfin/data/ を使用できます。 データ モデルの定義を参照してください。

import {
  entity,
  role,
  text,
  boolean,
  date,
  uuid,
} from '@microsoft/rayfin-core';

@entity()
@role('authenticated', '*', {
  policy: (claims, item) => claims.sub.eq(item.user_id),
})
export class Todo {
  @uuid() id!: string;
  @text({ min: 1, max: 100 }) title!: string;
  @boolean() isCompleted!: boolean;
  @date() createdAt!: Date;
  @date({ optional: true }) dueDate?: Date;
  @text({ max: 255 }) user_id!: string;
}

また、すべてのデータをアプリのデータベースに保存するのではなく、既存のデータに接続することもできます。 コネクタは、SQL 分析エンドポイントを通じてレイクハウスへの読み取りアクセスを提供し、Fabric 内の倉庫や SQL データベースに対する読み取りおよび書き込み操作をサポートし、セマンティックモデルに対するクエリを可能にします。 コネクタアクセスには適切なソース権限が必要です。基盤となるデータへのアクセスは付与しません。 「Fabric アプリを Fabric データに接続する」を参照してください。

これらのコネクタ以外のデータやサービスについては、関数を使用して外部 API およびサポートされている Azure および Fabric リソースを呼び出してください。 外部接続はアプリIDの権限を使用しますが、関数を通じたアプリのデータベースへのアクセスは呼び出し者の権限を保持します。 認証情報とリソーストークンはサーバー上に保管してください。 Connect Functions を外部リソースに接続するを参照してください。

Fabric アプリを使用するタイミング

Fabric アプリは次の場合に最適です。

  • 迅速なプロトタイピング – アイデアからライブURLまで、事前に設定されたインフラで数分で実現。
  • 社内ツールとダッシュボード – バックエンドのボイラープレートを書かずに認証済みの管理インターフェースを構築する。
  • データ探索と可視化 – コネクターを使ってサポートされるFabricデータ項目をクエリし、その結果をカスタムフロントエンドで表示します。
  • AIおよびエージェントアプリケーション – 永続状態を必要とするAIエージェント向けに構造化されたバックエンドサービスを提供します。

Fabric アプリは、次に適していない可能性があります。

  • 複雑なマルチステップ トランザクションまたはストアド プロシージャを必要とするアプリケーション。
  • 展開後に Fabric SSO 以外のサインインプロバイダーを必要とするアプリ。

セキュリティの責任

Fabricは、Fabricシングルサインオン(Microsoft Entra ID)、@roleデコレーターによる行レベルのセキュリティ、HTTPS、PKCE、ワークスペースおよびアイテムレベルの権限を提供します。

あなたの責任は以下の通りです:

  • シークレット、API キー、機密データをコード、フロントエンド資産、リポジトリから除外する。 ホスティングアクセスの設定に関わらず、フロントエンドの資産に秘密を保存しないでください。
  • Fabric SSO を通じてアプリが公開するものは、認証されたユーザーの表示と実行をコードが制御するため、サインインを制御します。
  • アプリをデプロイまたは管理するために必要なアクセス許可の共同作成者のみを付与する。
  • アプリが収集、処理、および格納するデータに対する法的およびコンプライアンスのアカウンタビリティ。

次のステップ