0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

[Databricks] Genie space を別ワークスペースに公開する方法(OpenSharing / Account-level Genie / Asset Bundles)

0
Posted at

はじめに

Databricks の AI/BI Genie space(現在の呼称は Genie Agent)を作ったあと、「別のワークスペースの人にも使わせたい」「組織横断で公開したい」となったとき、通常の共有ボタンだけでは届きません。

この記事では、Genie space をワークスペースをまたいで展開する方法を、公式ドキュメントの引用を添えて整理します。あわせて紛らわしい「Genie One」と「Account-level Genie」の関係、/one というURLの意味も確認します。

先に結論だけ挙げます。

  • 通常の共有(Share)は同一ワークスペース内に閉じます。共有相手はそのワークスペースのメンバーである必要があります。
  • ワークスペースをまたいで配る手段は3つあります。OpenSharing(Delta Sharing)/ Account-level Genie(Genie One のアカウントレベル)/ Asset Bundles の genie_space リソースです。
  • 「Genie One」は旧 Databricks One のことで、ワークスペースレベルとアカウントレベルの2形態を持ちます。/one は Genie 個別ではなく Databricks One / Genie One の統合入口を指します。

1. 通常の共有(Share)はワークスペース内に閉じる

Genie space の共有権限モデルは 4 段階です(CAN MANAGE / CAN EDIT / CAN RUN / CAN VIEW)。ただし共有相手(viewer)は、そのスペースが属するワークスペースのメンバーである必要があります。

viewers must be members of the workspace to interact with Genie Spaces

出典: AI/BI administration guide
https://docs.databricks.com/aws/en/ai-bi/admin

権限モデル自体の定義は次のドキュメントにあります。

出典: Create and manage a Genie Agent(CAN MANAGE / CAN EDIT / CAN RUN / CAN VIEW)
https://docs.databricks.com/aws/en/genie-agents/set-up

つまり権限付与の対象は、原則として同一ワークスペースのユーザー・グループ・サービスプリンシパルに限られます。ワークスペースをまたぐ場合は、この Share 機能ではなく、以下の別機能を使います。

2. ワークスペース間・組織間で展開する3つの方法

方法1: OpenSharing / Delta Sharing で共有

組織外(別アカウント・別 metastore の recipient)にも共有できます。共有した時点の point-in-time スナップショット(テーブル定義・instructions・curated SQL examples・SQL functions 等)を含む share を作成し、recipient 側がそれを mount して、データをプリロード済みのローカル Genie Agent として利用します。

制約は次のとおりです。

  • クリックした時点のスナップショットで、以降は更新されません(point-in-time)。
  • 圧縮後 256KB のサイズ制限があります。
  • metric view を含む Agent は共有できません。

出典: Share a Genie Space using OpenSharing
https://docs.databricks.com/aws/en/opensharing/share-genie-space

用途としては、組織外・別アカウントへの配布に向いています。

方法2: Account-level Genie(Genie One のアカウントレベル)

アカウント内の全ワークスペースを横断して、ダッシュボード・Genie Agent・Databricks Apps などを検索・発見できる統合エントリポイントです。アセットを開くと元のワークスペースで起動します。

  • 「明示的に共有されたアセットのみ」アクセスできます。
  • 各ワークスペースのデータ閲覧には、対応する Consumer access entitlement が必要です。
  • 有効化は account console の Settings → Feature enablement から行います。

出典: Account-level Genie
https://docs.databricks.com/aws/en/workspace/genie-account

用途としては、社内の複数ワークスペース利用者に一元的な入り口を提供したい場合に向いています。

方法3: Declarative Automation Bundles(旧 Asset Bundles)の genie_space リソース

2026-06-10 リリースの Databricks CLI 1.3.0 で genie_space リソースが追加されました。bundle generate genie-space で既存 Agent の定義(.geniespace.json)を生成し、別のワークスペースへ deploy して展開・移行できます(direct deployment engine が必須です)。

出典: Declarative Automation Bundles feature release notes(CLI 1.3.0 で genie_space 対応・2026-06-10)
https://docs.databricks.com/aws/en/release-notes/dev-tools/bundles

出典: Declarative Automation Bundles resources(genie_space リソース定義・direct deployment engine 必須・bundle generate genie-space)
https://docs.databricks.com/aws/en/dev-tools/bundles/resources

用途としては、dev → prod など環境間の複製・バージョン管理された移行(Git / IaC)に向いています。

3. 使い分けの整理

目的 推奨手段
組織外・別アカウントへ配布 OpenSharing
社内の複数ワークスペース利用者に一元的な入口を提供 Account-level Genie(Genie One)
dev → prod など環境間の複製・バージョン管理された移行 Asset Bundles の genie_space リソース

「組織横断で公開したいとき OpenSharing がよいか」への答えとしては、複数ワークスペースに分かれていて別ワークスペースの人にも使わせたいなら、OpenSharing は正しい選択肢の1つです。ただしスナップショット固定・256KB上限・metric view 不可の制約が許容できるかがポイントになります。頻繁に更新する Agent を常時最新で見せたいなら、Account-level Genie の方が向いています。

4. 「Genie One」と「Account-level Genie」の関係

「Genie One」は Databricks のビジネスユーザー向け簡易 UI(データ・AI の単一入口)の製品名で、旧称は Databricks One です。

Genie One was previously known as Databricks One

出典: What is Databricks One? / Use Genie One
https://docs.databricks.com/aws/en/workspace/databricks-one

「Account-level Genie(アカウントレベル Genie)」は、その Genie One の提供範囲を指す区分の1つです。両者は別物ではなく、「Genie One」という製品に「ワークスペースレベル」と「アカウントレベル」の2形態があり、後者が Account-level Genie(Account-level Databricks One)にあたります。

ワークスペースレベル vs アカウントレベル

区分 スコープ 入口URL形式 アクセス要件
ワークスペースレベル 単一ワークスペース https://<WORKSPACE_URL>/one?o=<WORKSPACE_ID> ワークスペースメンバーシップ+最低 Consumer access entitlement
アカウントレベル アカウント内の全ワークスペース横断 https://accounts.cloud.databricks.com/one(カスタムURL時は acme.databricks.com/one) 全アカウントユーザー可。ただし明示的に共有されたアセットのみ

users can navigate to the Genie One UI by adding /one to their workspace URL

出典: Use Genie One
https://docs.databricks.com/aws/en/genie-one/genie

出典: Account-level Databricks One(アカウントレベル入口 accounts.cloud.databricks.com/one)
https://docs.databricks.com/aws/en/workspace/databricks-one-account

出典: Give your Databricks account a custom URL(カスタムURL acme.databricks.com/one)
https://docs.databricks.com/aws/en/admin/account-settings/custom-url

5. /one のURLはどちらのレベルか見分ける

たとえば次のようなURLがどちらのレベルの入口か、ホスト名で判別できます。

https://<デプロイ名>.cloud.databricks.com/one?o=<WORKSPACE_ID>

このパターンはワークスペースレベルの Genie One(Databricks One)の入口です。判別の根拠は次のとおりです。

  • ホスト名が dbc-xxxx.cloud.databricks.com(=ワークスペースのデプロイURL)であり、アカウントコンソール accounts.cloud.databricks.com ではありません。
  • パス /one は Databricks One / Genie One の UI を指します(公式表現: "adding /one to their workspace URL")。Genie Agent 個別を直接指すものではなく、Genie One のトップ入口です。
  • クエリ o= は公式ドキュメントの https://<WORKSPACE_URL>/one?o=<WORKSPACE_ID> の形式そのもので、o= は WORKSPACE_ID を表します。

したがって、アカウントレベルではありません。アカウントレベルの入口は accounts.cloud.databricks.com/one(またはカスタムURL)という別ドメイン形式になります。

6. Account-level Genie に Genie Agent を「紐づける」手順は要るか

結論から言うと、Genie Agent を Account-level Genie に登録・アタッチするような専用操作は不要です。

Account-level Genie は、アカウント内の全ワークスペースのアセット(ダッシュボード・Genie Agent・Databricks Apps など)を横断的に発見・検索するディスカバリー面です。カタログ的な横断表示自体は自動で行われます。

Account-level Genie One is an account-wide discovery and search surface for dashboards, Genie Agents, Databricks Apps, and other assets

出典: Account-level Genie
https://docs.databricks.com/aws/en/workspace/genie-account

ただし、各ユーザーが実際に見て使えるのは「その人に明示的に共有されたアセットだけ」というアクセス制御が効きます。

Users can only access assets explicitly shared with them

出典: Account-level Genie
https://docs.databricks.com/aws/en/workspace/genie-account

したがって必要なのは次の2点です。管理者によるアカウントレベル機能の有効化と、各 Genie Agent を対象ユーザー・グループに Share することです。

この「明示的な共有」の実体

「明示的な共有」とは、Genie Agent の Share ダイアログでの共有付与そのものです。対象のユーザー・グループを入力して Add し、権限レベル(CAN VIEW / CAN RUN / CAN EDIT / CAN MANAGE)を設定します。全アカウントユーザーに開くなら "Select All account users" を選びます。

Enter the users or groups you want to share the agent with. Then, click Add and set appropriate permission levels.

出典: Create and manage a Genie Agent
https://docs.databricks.com/aws/en/genie-agents/set-up

「アカウントレベルに公開する」という専用のトグルやボタンは Genie Agent 側にはありません。共有がそのまま表示・利用可否を決めます。なお、データアクセスは常に Unity Catalog 権限に従うため、共有はメタ的な閲覧許可であり、裏側のデータ権限は別途 UC で担保する必要があります(発行者資格情報で動くケースを除く)。

エンドユーザー側の要件(Consumer access entitlement)

Account-level Genie One 自体は全アカウントユーザーが利用でき、Consumer access entitlement は不要です。

Account-level Genie One is available to all Databricks account users and does not require this entitlement.

出典: Account-level Databricks One
https://docs.databricks.com/aws/en/workspace/databricks-one-account

ただし、特定ワークスペースのデータを表示するには、そのワークスペースの Consumer access entitlement が必要です。ワークスペースレベル Genie One では workspace membership と最低 Consumer access entitlement が必須になります。Consumer access はワークスペース権限で、workspace settings での個別付与、または IdP グループ同期での一括付与ができます。

出典: What is consumer access?
https://docs.databricks.com/aws/en/ai-bi/consumers/

アカウントレベル Genie の有効化手順

アカウント管理者が account console で有効化します。account console → Settings → Feature enablement タブ → Genie のトグルで制御します。この設定は全アカウントユーザーに適用され、ワークスペースレベル Genie One には影響しません。Private Link 環境では、追加で inbound Private Link の設定が必要です。

出典: Account-level Databricks One
https://docs.databricks.com/aws/en/workspace/databricks-one-account

全体フロー

  1. 管理者がアカウントレベル Genie を有効化(Feature enablement)
  2. 各 Genie Agent を Share で対象ユーザー・グループ(または All account users)に権限付与
  3. 該当ワークスペースのデータ表示が要るユーザーには Consumer access entitlement を付与
  4. ユーザーは accounts.cloud.databricks.com/one から横断アクセス

専用の「アカウントレベルへ登録」ステップはなく、Share が表示・利用の鍵になります。

まとめ

  • Genie space の通常共有は同一ワークスペース内に閉じます。別ワークスペースに届けるには別手段が必要です。
  • 組織外配布は OpenSharing、複数ワークスペースの統合入口は Account-level Genie、環境間移行は Asset Bundles の genie_space を使い分けます。
  • 「Genie One」は旧 Databricks One で、ワークスペースレベルとアカウントレベルの2形態があります。/one はホスト名でどちらのレベルか判別できます。

参照した公式ドキュメント

(引用文は原文英語のまま転記しています。URL は 2026-07-19 時点の調査に基づきます。)

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?