Data sharing

Workspaces

A workspace is the top-level resource isolation unit in AI Studio. Knowledge bases, workflows, connectors, compute instances, Catalog objects, and other resources all belong to a workspace, and data is isolated between workspaces. Data mode, Agent mode, and other views all switch within the same workspace.

Entry point: the workspace switcher on the left side of the top bar, which displays the current workspace name.

My workspaces and joined workspaces

Type

Meaning

My workspaces

Workspaces that you created and own

Joined workspaces

Workspaces that others created and invited you to join

You can switch among workspaces that you have permission to access. Account-level pages, such as the billing center and personal account settings, generally do not display the workspace switcher.

Switch workspaces

  1. Click the workspace switcher in the top bar.

  2. Select a target under My Workspaces or Joined Workspaces.

  3. The UI switches to the resources and data in that workspace.

After switching, you see a different isolated set of resources. Content in the current workspace does not appear in other workspaces.

Create a workspace

  1. At the bottom of the workspace panel, click Add Workspace. The exact label may vary by UI.

  2. Enter a name. We recommend naming it after its project or purpose; observe the length limit shown in the UI.

  3. After creation, the UI generally switches to the new workspace automatically.

Rename a workspace

  1. In the panel, hover over a workspace that you own.

  2. Use the rename action, change the name, and save.

Workspaces that you joined are generally managed by their owners and cannot be renamed here.

Delete a workspace

  1. Use the delete action on a workspace that you own.

  2. Confirm deletion. If you delete the current workspace, the UI switches to another available workspace.

Deletion removes resources in that workspace and is generally irreversible. The default workspace usually cannot be deleted. Before deletion, confirm that data and tasks have been backed up or are no longer needed.

Copy a workspace ID

Copy the workspace ID from the workspace panel for API calls, cross-workspace data sharing, support tickets, and similar uses. For cross-account data sharing, the recipient often needs to provide this ID.

Operation overview

Operation

Scope

Note

Switch

All accessible workspaces

Data is completely isolated

Create

—

You can create multiple workspaces

Rename

My workspaces only

—

Delete

My workspaces only

The default workspace usually cannot be deleted; irreversible

Copy ID

Accessible workspaces

—

Home page and resource overview

After you enter a workspace, the home page or dashboard may summarize Catalog objects, tasks, resource status, and more, depending on the current product UI. For in-depth monitoring and alerts, see Monitoring and alerts. This page does not expand that topic.

Members and permissions

For inviting members, assigning roles, and complete user and role configuration within a workspace, see User permissions.

Data sharing

Publish data from this workspace’s Catalog to specified workspaces for them to subscribe to. Sharing uses a “publish → subscribe” model and does not provide public links; you must specify a target workspace when publishing.

Entry point: Resource Center → Data Sharing → Publish. For subscriber-side operations, see Data subscriptions.

Publish and subscribe model

Side

Who

What they do

Publisher

Data owner

Select objects from Catalog and specify target workspaces, permissions, and validity periods

Subscriber

Data consumer

Subscribe to received publications; the data enters their Catalog as a read-only “subscribed library”

A subscribed library always points to the source data maintained by the publisher. Subscribers see updates to the source; access ends when the publication is revoked or expires. This does not create two independent sources of truth.

Add a publication

  1. Go to Resource Center → Data Sharing, open the Publish tab, and click Publish.

  2. Enter a publication name (required).

  3. Select one publication object in the Catalog tree: catalog, database, volume, or table (models and operators are excluded).

  4. Specify one or more publication targets:

    • Select another workspace under the same account from the list; or

    • Enter a workspace ID to add a workspace under another account.

  5. Set publication permissions and a validity period, and optionally enter a note.

  6. Confirm the publication.

Field

Description

Publication name

Name of this publication

Publication object

A catalog, database, volume, or table in Catalog

Publication target

One or more target workspaces

Publication permission

Read-only or downloadable (see below)

Validity period

Permanent or a specified expiration date

Note

Optional description

Publication permissions

Permission

What subscribers can do

Read-only

Query and preview, but cannot download or export

Downloadable

Download or export in addition to read-only access

Subscribed libraries are never writable, regardless of the permission. Prefer read-only access for sensitive data.

View and manage publications

The Publish tab lists published data and supports searches by publication name, object, or target.

Operation

Description

Edit

Modify the name, object, target, permission, validity period, or note

Delete

Revoke the publication; target workspaces can no longer access the data

Access statistics

Publishers can view access counts, most recent access time, and similar statistics in a publication record to evaluate the value of sharing.

Usage notes (publish)

  • After publication, the recipient must actively subscribe from the Subscribe side before using the data.

  • When publishing at database level, later additions or removals within the database may also appear in the subscriber’s view.

  • Before publishing across accounts, carefully verify the recipient’s workspace ID.

  • Deleting a publication only stops subsequent access. Data that the recipient already exported under the Downloadable permission is outside platform control.

  • A publication is a read-only view of source data, not a frozen snapshot. If you need a fixed version, materialize it as a separate object before publishing.

Data subscriptions

After another workspace publishes data to your workspace, you must subscribe before you can use it. After subscription, the data appears in this workspace’s Catalog as a read-only subscribed library. Subject to its permissions, you can query or preview it or use it in downstream capabilities such as knowledge bases.

Entry point: Resource Center → Data Sharing → Subscribe. For publisher-side operations, see Data sharing.

Subscription list

The Subscribe tab lists data published to this workspace and supports searches by publication name or source workspace.

Field

Description

Publication name / object

The publisher’s name for the publication and the object type

Source workspace / publisher / publication time

Where the data came from

Subscription status

Subscribed / Not subscribed

Subscription location

For a subscription, its location and name in this workspace’s Catalog

Operation

Subscribe / Unsubscribe

Subscribe and unsubscribe

  1. Click Subscribe for the publication you want to use.

  2. In the dialog, enter:

    • Object name (required): the local name in this Catalog. You can change the default.

    • Subscription location (required):

      • Catalog-level object → workspace root

      • Database → select a catalog as its destination

      • Volume/table → select a database as its destination

  3. After confirmation, the data appears in the selected location as a read-only subscribed library.

  4. When it is no longer needed, click Unsubscribe. After confirmation, the subscribed library is removed and this workspace can no longer access the data.

View a subscribed library in Catalog

  1. Open Catalog and locate the object by the location and name selected during subscription.

  2. Expand it to view its tables, volumes, and other child objects.

  3. Open its details to preview samples in read-only mode.

The publisher maintains the contents and structure of the subscribed library. Access ends if the publisher revokes the publication or its validity period expires.

Permissions and validity periods set by the publisher

Permission

What you can do

Read-only

Query and preview, but cannot download or export

Downloadable

Download or export in addition to read-only access

Validity period

Description

Permanent

Remains valid until the publisher deletes the publication

Custom expiration

Access is automatically lost after expiration

Usage notes (subscribe)

  • Before unsubscribing, confirm that no query, knowledge base, workflow, or other resource still depends on the subscribed library.

  • Subscribed libraries are read-only, so changes cannot be saved. To transform the data, first read it and write it to an object in this workspace.

  • For long-term dependencies, agree with the publisher on permanent validity or timely renewal.

  • Choose a clear local name when subscribing, optionally with a source prefix, to distinguish external data.

Last updated on