table rename

Prev Next

This command renames a VAST Database table.

Usage

table rename --database-name DATABASE
             --schema-name SCHEMA
             --name OLD_TABLE_NAME
             --new-name NEW_TABLE_NAME
            [--tenant-id TENANT]          

Required Parameters

--database-name DATABASE

Specifies the name of the database containing the schema.

--schema-name SCHEMA

Specifies the name of the schema containing the table.

--name OLD_TABLE_NAME

Specifies the name of the table being renamed.

--new-name NEW_TABLE_NAME

Specifies the new name for the table. The name must meet the requirements for S3 object names.

Options

--tenant-id TENANT

Specifies the ID of the tenant where the database resides

If omitted, the default tenant is assumed.

Example

This example shows renaming a table named cats into dogs:

vcli: admin> table rename --name cats --schema-name schema1 --database_name vastdb --new-name dogs