mc table show

The mc table show command displays metadata for an Iceberg table on an MinIO AIStor cluster. mc table info is an alias for this command.

The output includes the table schema, properties, the table’s UUID, and other metadata.

The metadata output includes the table’s UUID, which is the identifier used in IAM table ARNs of the form arn:aws:s3tables:::bucket/{warehouse}/table/{uuid}. The UUID is stable across renames, so UUID-based policies continue to apply even if the table is renamed. For details on using the UUID in policies, see Controlling access to MinIO AIStor Tables.

Example

The following command displays metadata for the sales_data table in the prod namespace of the analytics warehouse on the myaistor MinIO AIStor cluster:

mc table show myaistor analytics prod sales_data

Syntax

The command has the following syntax:

mc [GLOBALFLAGS] table show ALIAS WAREHOUSE NAMESPACE TABLE

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.

NAMESPACE

Required

The name of the namespace containing the table.

TABLE

Required

The name of the table to display metadata for.

WAREHOUSE

Required

The name of the warehouse containing the table.

Global flags

This command supports any of the global flags.

Examples

Show table metadata

Use mc table show to display table metadata:

mc table show ALIAS WAREHOUSE NAMESPACE TABLE

Replace ALIAS with the alias of the MinIO AIStor cluster.
Replace WAREHOUSE with the name of the warehouse.
Replace NAMESPACE with the name of the namespace.
Replace TABLE with the name of the table.

Show table metadata with JSON output

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

mc table show myaistor analytics prod sales_data --json

The JSON output includes a table_uuid field:

{
  "status": "success",
  "table": "sales_data",
  "namespace": "prod",
  "warehouse": "analytics",
  "location": "s3://analytics/...",
  "format_version": 2,
  "table_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

In the default text output, the same value appears on the Table UUID: line. Use this UUID in IAM table ARNs; see Controlling access to MinIO AIStor Tables.