重要
この機能はプレビュー中です。
前提条件
- 有料の F2 以上のファブリック容量、または Microsoft Fabric が有効になっている容量あたりの Power BI Premium (P1 以上) 容量
- Fabric データ エージェントのテナント設定が有効になっている。
- AI のクロス geo 処理が有効になっています。
- AI のクロスジオ格納が有効になっています。
- データを含む少なくとも 1 つのデータ: ウェアハウス、レイクハウス、1 つ以上の Power BI セマンティック モデル、KQL データベース、またはオントロジ。
- POWER BI セマンティック モデルのデータ ソースに対して、XMLA エンドポイントテナントスイッチ を介して Power BI セマンティック モデルが有効になります。
公開とバージョン管理
Microsoft Fabric でのデータ エージェントの作成は、反復的なプロセスです。 これには、次に示すさまざまな構成の改良が含まれます。
- 関連テーブルの選択
- Fabric データ エージェントの定義手順
- 各データ ソースのクエリ例の作成
Fabric データ エージェントのパフォーマンスを向上させるために調整を行ったら、最終的にその Fabric データ エージェントを公開できます。 公開されると、読み取り専用バージョンが生成され、他のユーザーと共有できます。
Fabric データ エージェントの公開を試みるときに、Fabric データ エージェントの機能に関する説明を含めることができます。 この説明は、Fabric データ エージェントの目的と機能をコンシューマーが理解するのに役立ちます。 他の自動システムとオーケストレーターも、この説明を使って、Microsoft Fabric の外部で Fabric データ エージェントを呼び出すことができます。
注
Fabric データ エージェントに、それ自身の機能を説明するよう依頼できます。 その後、発行時に説明として使用する応答を絞り込んで要約できます。
Fabric データ エージェントを公開した後は、他のユーザーが使っている公開バージョンに影響を与えることなく、現在のドラフト バージョンを引き続き調整してパフォーマンスを向上させることができます。 これにより、変更が発行済みバージョンから分離されたままであることを認識して、自信を持って反復処理できます。 公開バージョンとドラフト バージョンをシームレスに切り替え、両方で同じクエリ セットをテストしてパフォーマンスを比較できます。 これは変更の効果を評価するのに役立ち、Fabric データ エージェントの有効性を向上させる方法に関する貴重な分析情報を得ることができます。 次のスクリーンショットは、Fabric データ エージェントの公開済みと開発済みのバージョンを切り替える方法を示したものです。
他の変更を行わずに Fabric データ エージェントの説明を更新するには、次のスクリーンショットで示すように、[設定] に移動し、[公開] を選んで説明を更新します。
アクセス許可モデルと必要なソース アクセスの共有
Fabric データ エージェント共有機能を使うと、次のスクリーンショットで示すように、さまざまなアクセス許可モデルを使って Fabric データ エージェントを他のユーザーと共有できます。
Fabric データ エージェントへのアクセスを完全に制御して、その使用を完全に管理できます。 さらに、Fabric データ エージェントを共有する場合は、それが使用する基になるデータへのアクセスも共有する必要があります。 Fabric データ エージェントでは、行レベル セキュリティ (RLS) や列レベル セキュリティ (CLS) など、データに対するすべてのユーザー アクセス許可が適用されます。
基になるデータ ソースのアクセス許可
ユーザーが Fabric データ エージェントを介して正常にクエリを実行するには、接続されているデータ ソースの種類ごとに、以下に示す最小限の有効なアクセス許可が必要です。 一覧に示されているアクセス許可より小さい場合、クエリは失敗するか、空の結果を返します。
| データ ソースの種類 | データ エージェント経由でクエリを実行するための最小限のアクセス許可 | 注記 |
|---|---|---|
| Power BI セマンティック モデル | ビルド (読み取りを含む) | エージェントはビルドを必要とするモデル クエリを生成するため、読み取りだけでは不十分です。 |
| Lakehouse | レイクハウスの項目の読み取り（適用される場合はテーブルへのアクセスも） | データを変更しない限り、書き込む必要はありません。 |
| 倉庫 | 関連テーブルに対するSELECTクエリの読み取り | DML/DDL 操作にのみ高権限を設定します。 |
| KQL データベース | データベースの閲覧者ロール | 上位の役割は管理コマンド専用です。 |
| オントロジ | オントロジ項目を読み取り、オントロジにバインドされた基になるセマンティック モデル、lakehouse、または KQL データベースを読み取ります | |
| サポートされているその他のソース | クエリおよび読み取りレベルのアクセス | メタデータとデータの取得を許可する必要があります。 |
重要
ユーザーがセマンティック モデルに対する読み取りアクセス許可 (ビルドなし) のみを持っている場合、Fabric データ エージェントは生成されたクエリを実行できません。 ビルドを許可して対話型クエリを有効にします。
最小限の特権に従う: 必要なデータ ソースのアクセス許可のみを付与します (セマンティック モデルの場合、これは通常、必要でない限り、より広範なワークスペース ロールを割り当てずにビルドすることを意味します)。
ユーザーが Fabric データ エージェントを開くことができるが、基になる 1 つ以上のソースに対する最小限のアクセス許可がない場合、ソースにアクセスするクエリは、ソースのセキュリティ モデルに応じて、承認エラーで失敗するか、空の結果を返します。
- アクセス許可を選択しない: 他のアクセス許可を選ばないと、ユーザーは Fabric データ エージェントの公開済みバージョンのクエリのみを実行できます。 ユーザーは、構成や詳細を編集したり、表示したりするためのアクセス権を持っていません。 これにより、Fabric データ エージェントの設定の整合性が維持されます。
- 詳細の表示: ユーザーは Fabric データ エージェントの公開済みとドラフトの両方のバージョンの詳細と構成を表示できますが、それを変更することはできません。 それでも、Fabric データ エージェントのクエリを実行し、意図しない変更を行うリスクなしに有益な分析情報を得ることができます。
- 詳細の編集と表示: ユーザーは Fabric データ エージェントの公開済みとドラフトの両方のバージョンの、すべての詳細と構成を表示および編集するためのフル アクセス権を持ちます。 Fabric データ エージェントのクエリを実行することもできるので、共同作業に最適です。
次のスクリーンショットは、選択できる実際のアクセス許可を示しています。
Fabric データ エージェントを公開する前に共有した場合、既定のアクセス許可を持つ (他のアクセス許可を持たない) ユーザーはクエリを実行できません。 このようになるのは、既定のアクセス許可ではユーザーは公開済みバージョンのクエリだけを許可され、公開済みバージョンがまだ存在しない場合、ユーザーは Fabric データ エージェントのクエリを実行できないためです。 その他のアクセス許可を持つユーザー (詳細の表示、または 編集と詳細の表示) は、下書きバージョンにのみアクセスできます。 次のスクリーンショットは、Fabric データ エージェントを公開しないで共有するオプションを示したものです。
