次の方法で共有


Genie スペースを埋め込む

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 埋め込みコードを生成できます。

  1. 埋め込みたい Genie のスペースを開きます。
  2. [共有] をクリックします。
  3. [共有]ダイアログボックスで、[ スペースを埋め込む]をクリックします。
  4. 生成された 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" を含めます。
  • 許可されるサーフェスを制限する: 信頼して制御できる埋め込みサーフェスリストにドメインのみを追加します。