mc table warehouse remove

The mc table warehouse remove command removes an Iceberg warehouse from the catalog on an AIStor cluster.

By default, this command removes only the warehouse registration from the catalog while preserving the underlying bucket and its contents. Use the --purge and --force flags together to also delete the underlying bucket and all its data.

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] table warehouse remove       \
                 ALIAS                        \
                 WAREHOUSE_NAME               \
                 [--force]                    \
                 [--purge]

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 an AIStor cluster from which to remove the warehouse.

WAREHOUSE_NAME

Required

The name of the warehouse to remove.

--force

Optional

Confirm the purge operation. Required when using --purge.

--purge

Optional

Purge the underlying bucket and all its contents when removing the warehouse. Requires the --force flag to confirm the operation.

Using --purge permanently deletes all data in the warehouse. This operation cannot be undone.

Global flags

This command supports any of the global flags.

Examples

Remove a warehouse from the catalog

Use mc table warehouse remove to remove a warehouse registration while preserving the underlying bucket:

mc table warehouse remove ALIAS WAREHOUSE_NAME

Replace ALIAS with the alias of the AIStor cluster.
Replace WAREHOUSE_NAME with the name of the warehouse to remove.

Remove a warehouse and purge all data

Use the --purge and --force flags to remove the warehouse and delete all underlying data:

mc table warehouse remove myaistor analytics --purge --force

Remove a warehouse with JSON output

Use the --json global flag to output the results in JSON format:

mc table warehouse remove myaistor analytics --json