mc table share update

The mc table share update command modifies an existing Delta Sharing configuration on an AIStor cluster.

Use this command to update the description, add tables, or remove tables from a share.

Parameters

ALIAS

Required

The alias of an AIStor cluster.

SHARE

Required

The name of the share configuration to update.

--add

Optional

Add a table to the share using one of the following formats:

Type Format
Delta SCHEMA:NAME:delta:BUCKET:PATH
UniForm SCHEMA:NAME:uniform:WAREHOUSE:NAMESPACE:TABLE

Delta table fields:

  • SCHEMA - Schema name within the share
  • 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:

  • SCHEMA - Schema name within the share
  • 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

Update the share description. Use an empty string ("") to clear the description.

--remove

Optional

Remove tables from the share. Specify tables in SCHEMA/TABLE format, separated by commas for multiple tables.

Global flags

This command supports any of the global flags.

Examples

Update share description

Use mc table share update to change the share description:

mc table share update myaistor/analytics-share \
    --description "Updated analytics share"

Clear share description

Use an empty string to clear the description:

mc table share update myaistor/analytics-share --description ""

Add a Delta table

Use the --add flag to add a Delta Lake table to the share:

mc table share update myaistor/analytics-share \
    --add "default:sales:delta:data-bucket:/delta/sales/"

Add a UniForm table

Use the --add flag to add an Iceberg table via UniForm:

mc table share update myaistor/analytics-share \
    --add "public:orders:uniform:warehouse:tpch:orders"

Remove tables from a share

Use the --remove flag to remove tables:

mc table share update myaistor/analytics-share \
    --remove "default/old_table,public/deprecated"

Combined update operation

Update description and modify tables in a single command:

mc table share update myaistor/analytics-share \
    --description "Q1 2025 data" \
    --add "default:new_table:delta:bucket:/path/" \
    --remove "default/legacy_table"