Catalog and semantic-model tasks

Use catalog to browse and manage catalogs, databases, tables, volumes, and files. Before writing, inspect the resource tree and confirm the target workspace and resource ID.

moi-cli -o catalog tree
moi-cli -o catalog list
moi-cli catalog --help

catalog tree returns the workspace data-resource hierarchy. Creating, updating, truncating, or deleting resources, and uploading files, can affect workspace data.

Common Catalog operations

Task

Commands

Catalogs

list, create, info, update, delete

Databases

list-databases, create-database, database-info, delete-database

Tables

create-table, table-info, preview-table, truncate-table, delete-table

Volumes and files

create-volume, files, upload, file-info, download-file, delete-file

For complex requests, use confirmed input with --json or --json-file for the relevant subcommand. Do not infer field names from other commands. Before deletion, read resource details or the full path to confirm the target ID and workspace.

Data assets and advanced file operations

Task

Commands

Notes

Upload private files

upload-private-bytes, upload-private-file, upload-private

Private data remains governed by workspace permissions and volume scope.

Inspect data assets or artifacts

data-asset, batch-get-data-assets, file-data-asset, file-artifact, batch-resolve-file-artifacts

Use file identifiers to inspect related resources.

Query system resources or request NL2SQL

system-tree, run-nl2sql

Use the commands for the system hierarchy and NL2SQL requests respectively.

These commands have different input and response objects. For complex requests, run moi-cli catalog <subcommand> -help first, then provide confirmed fields with --json or --json-file.

Last updated on