Skip to main content
Last updated on

Mount a shared Genie Space

Beta

Genie Space sharing using OpenSharing is in Beta.

When a data provider shares a Genie Space with you using OpenSharing, you can mount that share to create a local Genie Space in your workspace. The local space comes pre-loaded with the provider's data assets and instructions so you can start asking questions right away.

You have full ownership of your local Genie Space. You can add your own data, modify the instructions, and reconfigure the space. Your changes do not affect the provider's original space.

For information about how providers share Genie Spaces, see Share a Genie Space using OpenSharing.

Requirements​

To mount a shared Genie Space, you must have the following:

  • USE PROVIDER privilege on the Unity Catalog metastore in your workspace, or ownership of the provider object.
  • CREATE CATALOG privilege on your Unity Catalog metastore.
  • Access to a pro or serverless SQL warehouse in your workspace.

Mount a shared Genie Space​

  1. In your Databricks workspace, click Data icon. Catalog.

  2. At the top of the Catalog pane, click the Gear icon. gear icon and select OpenSharing.

    Alternatively, in the upper-right corner, click Share > OpenSharing.

  3. Find and select the provider who shared the Genie Space with you.

  4. Find the share that contains the Genie Space and click Mount as Genie agent.

  5. Optionally, expand Advanced options to specify the catalog name, SQL warehouse, and workspace folder. Databricks provides defaults based on the provider and share names.

  6. Click Mount.

Databricks mounts the share's data to the catalog you specified in your Unity Catalog metastore and creates a local Genie Space pre-loaded with the provider's data assets and instructions. Databricks rewrites all table references in the instructions and SQL examples to point to your mounted catalog.

Work with your mounted Genie Space​

Your local Genie Space comes with:

  • All of the provider's data assets, available through a catalog in your Unity Catalog metastore.
  • The provider's instructions, curated SQL examples, and SQL functions, rewritten to reference your mounted catalog.

Your local Genie Space is yours to modify. You can:

  • Add your own tables and views.
  • Edit or extend the instructions and SQL examples.
  • Share the space with other users in your workspace.
  • Reconfigure or change the SQL warehouse.
note

The provider's tables are read-only. You can query them but cannot write to them.

Find your mounted space​

After mounting, your new Genie Space appears in the standard Genie Spaces list in your workspace. The mounted catalog also appears in Catalog Explorer under the name you specified or the autogenerated default.

Limitations​

  • External sharing: You cannot share the mounted Genie Space with users outside your organization using OpenSharing. OpenSharing recipients cannot re-share data assets received from a provider.

Next steps​

On this page