mc table namespace create

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

A namespace is an organizational unit within a warehouse that groups related tables. Namespaces can have custom properties for categorization and management.

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] table namespace create       \
                 ALIAS                        \
                 WAREHOUSE                    \
                 NAMESPACE                    \
                 [--attr "key=value"]         \
                 [--ignore-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 AIStor cluster on which to create the namespace.

NAMESPACE

Required

The name of the namespace to create.

WAREHOUSE

Required

The name of the warehouse in which to create the namespace.

--attr

Alias: -a

Optional

Add a custom property for the namespace in key=value format. You can specify multiple --attr parameters` to add multiple properties.

--ignore-existing

Alias: -p

Optional

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

Global flags

This command supports any of the global flags.

Examples

Create a namespace

Use mc table namespace create to create a new namespace:

mc table namespace create ALIAS WAREHOUSE NAMESPACE

Replace ALIAS with the alias of the AIStor cluster.
Replace WAREHOUSE with the name of the warehouse.
Replace NAMESPACE with the name for the new namespace.

Create a namespace with custom properties

Use the --attr flag to add custom properties when creating a namespace:

mc table namespace create myaistor analytics prod --attr owner=data-team --attr env=production