mc table share update

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

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

The following command adds a table to the analytics-share on the myaistor MinIO AIStor cluster:

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

The command has the following syntax:

mc [GLOBALFLAGS] table share update           \
                 ALIAS/SHARE                  \
                 [--description "STRING"]     \
                 [--add "SCHEMA:TABLESPEC"]   \
                 [--remove "SCHEMA/TABLE"]

Brackets [] indicate optional parameters.
Parameters sharing a line are mutually dependent.
Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

ALIAS

Required

The alias of a MinIO AIStor cluster.

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`
Iceberg	`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

Iceberg 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

Use mc table share update to change the share description:

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

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 an Iceberg table

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

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

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"

mc table share update

On this page