mc table warehouse create

The mc table warehouse create command creates a new Iceberg warehouse on a 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]         \
                 [--sse-s3 | --sse-kms]       \
                 [--sse-kms-key-id KEY]

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 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.

--sse-s3

Optional

Enable SSE-S3 server-side encryption on the warehouse, using keys managed by MinIO AIStor.

Mutually exclusive with --sse-kms.

--sse-kms

Optional

Enable SSE-KMS server-side encryption on the warehouse, using keys managed by an external key management service.

Requires --sse-kms-key-id. Mutually exclusive with --sse-s3.

--sse-kms-key-id

Optional

The key management service (KMS) key ID to use for SSE-KMS encryption.

This flag is required when you specify --sse-kms. It cannot be used with --sse-s3 or without --sse-kms.

To change the encryption configuration of an existing warehouse or table, use mc table encrypt.

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

Create a warehouse with SSE-S3 encryption

Use the --sse-s3 flag to enable server-side encryption with keys managed by MinIO AIStor:

mc table warehouse create --sse-s3 myaistor analytics

Create a warehouse with SSE-KMS encryption

Use the --sse-kms and --sse-kms-key-id flags to enable server-side encryption with an external key management service:

mc table warehouse create --sse-kms --sse-kms-key-id my-key-id myaistor analytics