はじめに
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
全体フロー
- 管理者がアカウントレベル Genie を有効化(Feature enablement)
- 各 Genie Agent を Share で対象ユーザー・グループ(または All account users)に権限付与
- 該当ワークスペースのデータ表示が要るユーザーには Consumer access entitlement を付与
- ユーザーは
accounts.cloud.databricks.com/oneから横断アクセス
専用の「アカウントレベルへ登録」ステップはなく、Share が表示・利用の鍵になります。
まとめ
- Genie space の通常共有は同一ワークスペース内に閉じます。別ワークスペースに届けるには別手段が必要です。
- 組織外配布は OpenSharing、複数ワークスペースの統合入口は Account-level Genie、環境間移行は Asset Bundles の
genie_spaceを使い分けます。 - 「Genie One」は旧 Databricks One で、ワークスペースレベルとアカウントレベルの2形態があります。
/oneはホスト名でどちらのレベルか判別できます。
参照した公式ドキュメント
- AI/BI administration guide: https://docs.databricks.com/aws/en/ai-bi/admin
- Create and manage a Genie Agent: https://docs.databricks.com/aws/en/genie-agents/set-up
- Share a Genie Space using OpenSharing: https://docs.databricks.com/aws/en/opensharing/share-genie-space
- Account-level Genie: https://docs.databricks.com/aws/en/workspace/genie-account
- Declarative Automation Bundles feature release notes: https://docs.databricks.com/aws/en/release-notes/dev-tools/bundles
- Declarative Automation Bundles resources: https://docs.databricks.com/aws/en/dev-tools/bundles/resources
- What is Databricks One? / Use Genie One: https://docs.databricks.com/aws/en/workspace/databricks-one
- Account-level Databricks One: https://docs.databricks.com/aws/en/workspace/databricks-one-account
- Use Genie One: https://docs.databricks.com/aws/en/genie-one/genie
- Give your Databricks account a custom URL: https://docs.databricks.com/aws/en/admin/account-settings/custom-url
- What is consumer access?: https://docs.databricks.com/aws/en/ai-bi/consumers/
(引用文は原文英語のまま転記しています。URL は 2026-07-19 時点の調査に基づきます。)