---
title: "table rename"
slug: "table-rename"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
canonical: "docs.vastdata.com/table-rename"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# table rename

This command renames a VAST Database table.

## Usage

```plaintext
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`:

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