docs-v2/content/shared/influxctl/table/rename.md

40 lines
1.2 KiB
Markdown

The `influxctl table rename` command renames a table in the specified database in
an {{< product-name omit=" Clustered" >}} cluster.
## Usage
<!-- pytest.mark.skip -->
```bash
influxctl table rename [flags] <DATABASE_NAME> <CURRENT_TABLE_NAME> <NEW_TABLE_NAME>
```
## Arguments
| Argument | Description |
| :--------------------- | :----------------------------------- |
| **DATABASE_NAME** | Name of the database the table is in |
| **CURRENT_TABLE_NAME** | Current name of the table |
| **NEW_TABLE_NAME** | New name for the table |
## Flags
| Flag | | Description |
| :--- | :--------- | :-------------------------------------------- |
| | `--format` | Output format (`table` _(default)_ or `json`) |
| `-h` | `--help` | Output command help |
{{% caption %}}
_Also see [`influxctl` global flags](/influxdb3/version/reference/cli/influxctl/#global-flags)._
{{% /caption %}}
## Examples
<!-- pytest.mark.skip -->
```bash
# Rename the "example-tb" table to "example_tb"
influxctl table rename mydb example-tb example_tb
```