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