mc table share create

The mc table share create command creates a new Delta Sharing configuration on an AIStor cluster.

A share configuration defines a named collection of tables that can be accessed by external consumers through Delta Sharing tokens.

Parameters

ALIAS

Required

The alias of an AIStor cluster on which to create the share.

SHARE

Required

The name for the new share configuration.

SCHEMA

Required

The schema name within the share to contain the table.

TABLE

Required

The table specification in one of the following formats:

Type Format Description
Delta NAME:delta:BUCKET:PATH A Delta Lake table stored in object storage.
UniForm NAME:uniform:WAREHOUSE:NAMESPACE:TABLE An Iceberg table accessed via UniForm.

Delta table fields:

  • NAME - Table name as seen by share consumers
  • BUCKET - Bucket containing the Delta table
  • PATH - Path to the Delta table within the bucket

UniForm table fields:

  • NAME - Table name as seen by share consumers
  • WAREHOUSE - Bucket containing Iceberg warehouse metadata
  • NAMESPACE - Database or schema name in the Iceberg catalog
  • TABLE - Table name in the Iceberg catalog

--description

Optional

A description for the share configuration.

Global flags

This command supports any of the global flags.

Examples

Create a share with a Delta table

Use mc table share create to create a share with a Delta Lake table:

mc table share create ALIAS/SHARE SCHEMA "NAME:delta:BUCKET:PATH"
  • Replace ALIAS with the alias of the AIStor cluster.
  • Replace SHARE with the name for the new share.
  • Replace SCHEMA with the schema name within the share.
  • Replace NAME with the table name consumers will see.
  • Replace BUCKET with the bucket containing the Delta table.
  • Replace PATH with the path to the Delta table.

Create a share with a UniForm table

Use mc table share create to create a share with an Iceberg table via UniForm:

mc table share create myaistor/catalog-share public \
    "orders:uniform:warehouse-bucket:tpch:orders" \
    --description "TPC-H orders via UniForm"

Create a share with description

Use the --description flag to add a description:

mc table share create myaistor/analytics-share default \
    "sales:delta:data-bucket:/delta/sales/" \
    --description "Analytics data share for BI team"