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 and object type for this publication |
Source workspace/publisher/publication time |
Where data comes from |
Subscription status |
Subscribed / not subscribed |
Subscription location |
Its location and name in this workspace’s Catalog when subscribed |
Task |
Subscribe / Unsubscribe |
Subscribe and unsubscribe¶
Subscription location (required):
Catalog-level object → workspace root
Database → select a catalog as its destination
Volume/table → select a database as its destination
After confirmation, the data appears in the selected location as a read-only subscribed library.
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 subscribed objects in Catalog¶
Open Catalog and locate the object by the location and name selected during subscription.
Expand it to view its tables, volumes, and other child objects.
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 on subscribed objects¶
Subscribed objects are read-only. Available operations follow the permissions shown in publication records and object details.
Usage notes¶
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.
View a subscribed table’s structure¶
Open the subscribed database in Catalog, select the table, and inspect fields, DDL and available samples. Check the published source, especially when names overlap.
If access fails, inspect subscription state, source validity, permissions and the visible error before deleting and recreating the subscription. Schema inspection keeps the subscription read-only.