# 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](subscribe.md).

## 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

- 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.