Important
この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。
Genie スペースを iframe として外部の Web サイトまたはアプリケーションに埋め込むことができます。 これにより、ビジネス ユーザーは、Azure Databricksに移動することなく、内部ツールまたはポータル内で Genie と直接やり取りできます。
必要条件
Genie スペースを埋め込む前に、次の条件を満たす必要があります。
- ワークスペース管理者: Genie のアクセス管理設定で、許可された埋め込みサーフェスを構成する必要があります。
- スペース作成者: Genie 空間に対する CAN MANAGE アクセス許可を少なくとも持っている必要があります。
- エンド ユーザー: Genie 空間と、それが使用する基になるデータ資産に明示的にアクセスできる必要があります。 Azure Databricksにサインインしていないユーザーは、埋め込み領域と対話する前に認証を求められます。
注
埋め込み Genie スペース ユーザーはプロンプトを送信できますが、スペース構成を編集することはできません。
手順 1: 機能プレビューを有効にする
ワークスペース管理者は、ワークスペースで機能を使用できるようにするには、プレビュー ページから iframe として Genie を埋め込むを有効にする必要があります。
手順 2: 許可された埋め込みサーフェスを構成する
ワークスペース管理者は、Genie スペースを埋め込む前に、許可された埋め込みサーフェスを構成する必要があります。 「ダッシュボードと Genie 空間埋め込みの管理」を参照してください。
手順 3: iframe コードを生成する
管理者が許可されたサーフェスを構成した後、スペース作成者は iframe 埋め込みコードを生成できます。
- 埋め込みたい Genie のスペースを開きます。
- [共有] をクリックします。
- [共有]ダイアログボックスで、[ スペースを埋め込む]をクリックします。
- 生成された iframe コードをコピーします。
手順 4: iframe をアプリケーションに追加する
iframe コードを外部の Web サイトまたはアプリケーションに貼り付けます。
CSV データのコピーや会話リンクのコピーなど、完全な機能を有効にするには、 allow="clipboard-write" 属性を iframe 要素に追加します。
<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>
ベスト プラクティス
- 明示的なデータ アクセスを許可する: エンド ユーザーが Genie 空間と、その領域で使用されるすべての基になるデータ資産の両方にアクセスできることを確認します。 ユーザーには、アクセス許可を持つデータのみが表示されます。
-
クリップボードへのアクセスを有効にする: ユーザーがクエリ結果と会話リンクをコピーできるように、iframe 要素に
allow="clipboard-write"を含めます。 - 許可されるサーフェスを制限する: 信頼して制御できる埋め込みサーフェスリストにドメインのみを追加します。