ReferenceAIStor Clientmc tablemc table warehouse

mc table warehouse remove

The mc table warehouse remove command removes an Iceberg warehouse from the catalog on a MinIO 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.

The following command removes the analytics warehouse from the myaistor MinIO AIStor cluster:

mc table warehouse remove myaistor analytics

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 a MinIO 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 MinIO 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

mc table warehouse maintenance update

Previous Page

mc table warehouse tag

Next Page

On this page

ParametersALIASWAREHOUSE_NAME--force--purgeGlobal flagsExamplesRemove a warehouse from the catalogRemove a warehouse and purge all dataRemove a warehouse with JSON output