Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 65 additions & 0 deletions content/influxdb3/cloud-dedicated/admin/tables/undelete.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
title: Undelete a table
description: >
Use the [`influxctl table undelete` command](/influxdb3/cloud-dedicated/reference/cli/influxctl/table/undelete/)
to restore a previously deleted table in your {{< product-name omit=" Cluster" >}} cluster.
menu:
influxdb3_cloud_dedicated:
parent: Manage tables
weight: 204
list_code_example: |
```bash { placeholders="DATABASE_NAME|TABLE_ID" }
influxctl table undelete DATABASE_NAME TABLE_ID
```
related:
- /influxdb3/cloud-dedicated/reference/cli/influxctl/table/undelete/
- /influxdb3/cloud-dedicated/admin/tables/delete/
- /influxdb3/cloud-dedicated/admin/tokens/table/create/
---

Use the [`influxctl table undelete` command](/influxdb3/cloud-dedicated/reference/cli/influxctl/table/undelete/)
to restore a previously deleted table in your {{< product-name omit=" Cluster" >}} cluster.

> [!Important]
> To undelete a table:
>
> - A new table with the same name cannot already exist.
> - You must have appropriate permissions to manage databases.

When you undelete a table, it is restored with the same partition template and
other settings as when it was deleted.

> [!Warning]
> Tables can only be undeleted for
> {{% show-in "cloud-dedicated" %}}approximately 14 days{{% /show-in %}}{{% show-in "clustered" %}}a configurable "hard-delete" grace period{{% /show-in %}}
> after they are deleted.
> After this grace period, all Parquet files associated with the deleted table
> are permanently removed and the table cannot be undeleted.

## Undelete a table using the influxctl CLI

```bash { placeholders="DATABASE_NAME|TABLE_ID" }
influxctl table undelete DATABASE_NAME TABLE_ID
```

Replace the following:

- {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}:
Name of the database associated with the deleted table
- {{% code-placeholder-key %}}`TABLE_ID`{{% /code-placeholder-key %}}:
ID of the deleted table to restore

> [!Tip]
> #### View deleted table IDs
>
> To view the IDs of deleted tables, use the `influxctl table list` command with
> the `--filter-status=deleted` flag--for example:
>
> <!--pytest.mark.skip-->
>
> ```bash {placeholders="DATABASE_NAME" }
> influxctl table list --filter-status=deleted DATABASE_NAME
> ```
>
> Replace {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}
> with the name of the database associated with the table you want to undelete.
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
title: influxctl table undelete
description: >
The `influxctl table undelete` command undeletes a previously deleted
table in an {{% product-name omit=" Clustered" %}} cluster.
menu:
influxdb3_cloud_dedicated:
parent: influxctl table
weight: 301
metadata: [influxctl 2.10.4+]
source: /shared/influxctl/table/undelete.md
---

<!-- //SOURCE content/shared/influxctl/table/undelete.md -->
66 changes: 66 additions & 0 deletions content/influxdb3/clustered/admin/tables/undelete.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
title: Undelete a table
description: >
Use the [`influxctl table undelete` command](/influxdb3/clustered/reference/cli/influxctl/table/undelete/)
to restore a previously deleted table in your {{< product-name omit=" Cluster" >}} cluster.
menu:
influxdb3_clustered:
parent: Manage tables
weight: 204
list_code_example: |
```bash { placeholders="DATABASE_NAME|TABLE_ID" }
influxctl table undelete DATABASE_NAME TABLE_ID
```
related:
- /influxdb3/clustered/reference/cli/influxctl/table/undelete/
- /influxdb3/clustered/admin/tables/delete/
- /influxdb3/clustered/admin/tokens/table/create/
draft: true # hide until next clustered release
---

Use the [`influxctl table undelete` command](/influxdb3/clustered/reference/cli/influxctl/table/undelete/)
to restore a previously deleted table in your {{< product-name omit=" Cluster" >}} cluster.

> [!Important]
> To undelete a table:
>
> - A new table with the same name cannot already exist.
> - You must have appropriate permissions to manage databases.

When you undelete a table, it is restored with the same partition template and
other settings as when it was deleted.

> [!Warning]
> Tables can only be undeleted for
> {{% show-in "cloud-dedicated" %}}approximately 14 days{{% /show-in %}}{{% show-in "clustered" %}}a configurable "hard-delete" grace period{{% /show-in %}}
> after they are deleted.
> After this grace period, all Parquet files associated with the deleted table
> are permanently removed and the table cannot be undeleted.

## Undelete a table using the influxctl CLI

```bash { placeholders="DATABASE_NAME|TABLE_ID" }
influxctl table undelete DATABASE_NAME TABLE_ID
```

Replace the following:

- {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}:
Name of the database associated with the deleted table
- {{% code-placeholder-key %}}`TABLE_ID`{{% /code-placeholder-key %}}:
ID of the deleted table to restore

> [!Tip]
> #### View deleted table IDs
>
> To view the IDs of deleted tables, use the `influxctl table list` command with
> the `--filter-status=deleted` flag--for example:
>
> <!--pytest.mark.skip-->
>
> ```bash {placeholders="DATABASE_NAME" }
> influxctl table list --filter-status=deleted DATABASE_NAME
> ```
>
> Replace {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}
> with the name of the database associated with the table you want to undelete.
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
title: influxctl table undelete
description: >
The `influxctl table undelete` command undeletes a previously deleted
table in an {{% product-name omit=" Clustered" %}} cluster.
menu:
influxdb3_clustered:
parent: influxctl table
weight: 301
metadata: [influxctl 2.10.4+]
source: /shared/influxctl/table/undelete.md
draft: true # hide until next clustered release
---

<!-- //SOURCE content/shared/influxctl/table/undelete.md -->
9 changes: 5 additions & 4 deletions content/shared/influxctl/database/list.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,11 @@ influxctl database list [--format=table|json]

## Flags

| Flag | | Description |
| :--- | :--------- | :-------------------------------------------- |
| | `--format` | Output format (`table` _(default)_ or `json`) |
| `-h` | `--help` | Output command help |
| Flag | | Description |
| :--- | :---------------- | :----------------------------------------------------------------------------- |
| | `--filter-status` | Only list databases with a specific status (`active` _(default)_ or `deleted`) |
| | `--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)._
Expand Down
26 changes: 26 additions & 0 deletions content/shared/influxctl/release-notes.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,29 @@
## 2.10.4 {date="2025-09-22"}

### Features

- Add the [`influxctl table undelete` command](/influxdb3/version/reference/cli/influxctl/table/undelete/).
- Add `--filter-status` flag to the [`influxctl database list` command](/influxdb3/version/reference/cli/influxctl/database/list/).

### Bug Fixes

- Allow changing only maxTables or maxColumns individually.

### Dependency updates

- Update `github.com/apache/arrow-go/v18` from 18.4.0 to 18.4.1.
- Update `github.com/golang-jwt/jwt/v5` from 5.2.3 to 5.3.0.
- Update `github.com/stretchr/testify` from 1.10.0 to 1.11.1.
- Update `golang.org/x/mod` from 0.26.0 to 0.28.0.
- Update `golang.org/x/oauth2` from 0.30.0 to 0.31.0.
- Update `google.golang.org/grpc` from 1.74.2 to 1.75.1.
- Update `google.golang.org/protobuf` from 1.36.6 to 1.36.9.
- Update `helm.sh/helm/v3` from 3.18.4 to 3.18.5.
- Update IOxProxy Protobuf.
- Update IOxProxy proto to include `UndeleteTable`.
- Upgrade Go to 1.25.1.
- Upgrade `make` dependencies.

## 2.10.3 {date="2025-07-30"}

### Features
Expand Down
9 changes: 5 additions & 4 deletions content/shared/influxctl/table/list.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,10 +16,11 @@ influxctl table list [flags] <DATABASE_NAME>

## Flags

| Flag | | Description |
| :--- | :--------- | :-------------------------------------------- |
| | `--format` | Output format (`table` _(default)_ or `json`) |
| `-h` | `--help` | Output command help |
| Flag | | Description |
| :--- | :---------------- | :-------------------------------------------------------------------------- |
| | `--filter-status` | Only list tables with a specific status (`active` _(default)_ or `deleted`) |
| | `--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)._
Expand Down
49 changes: 49 additions & 0 deletions content/shared/influxctl/table/undelete.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@

The `influxctl table undelete` command undeletes a previously deleted
table in an {{% product-name omit=" Clustered" %}} cluster and restores the
table with the same partition template and other table settings present when the
table was deleted.

> [!Important]
> The table name must match the name of the deleted table and
> **a new, active table with the same name cannot exist**.

## Usage

<!-- pytest.mark.skip -->

```bash
influxctl table undelete <DATABASE_NAME> <TABLE_ID>
```

## Arguments

| Argument | Description |
| :---------------- | :----------------------------------------------------------- |
| **DATABASE_NAME** | The name of the database that contains the table to undelete |
| **TABLE_ID** | The ID of the table to undelete |

> [!Tip]
> #### View deleted table IDs
>
> To view the IDs of deleted tables, use the `influxctl table list` command with
> the `--filter-status=deleted` flag--for example:
>
> <!--pytest.mark.skip-->
>
> ```bash {placeholders="DATABASE_NAME" }
> influxctl table list --filter-status=deleted DATABASE_NAME
> ```
>
> Replace {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}
> with the name of the database associated with the table you want to undelete.

## Flags

| Flag | | Description |
| :--- | :--------- | :-------------------------------------------- |
| `-h` | `--help` | Output command help |

{{% caption %}}
_Also see [`influxctl` global flags](/influxdb3/version/reference/cli/influxctl/#global-flags)._
{{% /caption %}}
2 changes: 1 addition & 1 deletion data/products.yml
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ influxdb3_cloud_dedicated:
list_order: 3
latest: cloud-dedicated
link: "https://www.influxdata.com/contact-sales-cloud-dedicated/"
latest_cli: 2.10.3
latest_cli: 2.10.4
placeholder_host: cluster-id.a.influxdb.io
ai_sample_questions:
- How do I migrate from InfluxDB v1 to InfluxDB Cloud Dedicated?
Expand Down