mc table warehouse create

The mc table warehouse create command creates a new Iceberg warehouse on an MinIO AIStor cluster.

A warehouse is the top-level organizational unit in the Iceberg catalog hierarchy. Creating a warehouse also creates a corresponding bucket to store Iceberg table data and metadata.

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] table warehouse create       \
                 ALIAS                        \
                 WAREHOUSE_NAME               \
                 [--ignore-existing]          \
                 [--upgrade-existing]

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 MinIO AIStor cluster on which to create the warehouse.

WAREHOUSE_NAME

Required

The name of the warehouse to create. This name is also used for the underlying bucket that stores the Iceberg data.

The names minio and aistor are reserved for internal use and cannot be used as warehouse names. aistor is the system warehouse that AIStor uses for internal metadata. See Reserved bucket and warehouse names for details.

--ignore-existing

Alias: -p

Optional

Do not return an error if a warehouse with the specified name already exists.

--upgrade-existing

Optional

Upgrade an existing bucket to a warehouse. Use this flag when you have an existing bucket that you want to enable as an Iceberg warehouse.

Global flags

This command supports any of the global flags.

Examples

Create a new warehouse

Use mc table warehouse create to create a new warehouse:

mc table warehouse create ALIAS WAREHOUSE_NAME

Replace ALIAS with the alias of the MinIO AIStor cluster.
Replace WAREHOUSE_NAME with the name for the new warehouse.

Create a warehouse if it does not exist

Use the --ignore-existing flag to avoid errors if the warehouse already exists:

mc table warehouse create --ignore-existing myaistor analytics

Upgrade an existing bucket to a warehouse

Use the --upgrade-existing flag to convert an existing bucket into a warehouse:

mc table warehouse create --upgrade-existing myaistor mybucket