diff --git a/content/influxdb3/cloud-dedicated/admin/tables/undelete.md b/content/influxdb3/cloud-dedicated/admin/tables/undelete.md new file mode 100644 index 000000000..a88c01141 --- /dev/null +++ b/content/influxdb3/cloud-dedicated/admin/tables/undelete.md @@ -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: +> +> +> +> ```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. diff --git a/content/influxdb3/cloud-dedicated/reference/cli/influxctl/table/undelete.md b/content/influxdb3/cloud-dedicated/reference/cli/influxctl/table/undelete.md new file mode 100644 index 000000000..ef90728a4 --- /dev/null +++ b/content/influxdb3/cloud-dedicated/reference/cli/influxctl/table/undelete.md @@ -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 +--- + + diff --git a/content/influxdb3/clustered/admin/tables/undelete.md b/content/influxdb3/clustered/admin/tables/undelete.md new file mode 100644 index 000000000..f5558c996 --- /dev/null +++ b/content/influxdb3/clustered/admin/tables/undelete.md @@ -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: +> +> +> +> ```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. diff --git a/content/influxdb3/clustered/reference/cli/influxctl/table/undelete.md b/content/influxdb3/clustered/reference/cli/influxctl/table/undelete.md new file mode 100644 index 000000000..b491255c0 --- /dev/null +++ b/content/influxdb3/clustered/reference/cli/influxctl/table/undelete.md @@ -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 +--- + + diff --git a/content/shared/influxctl/database/list.md b/content/shared/influxctl/database/list.md index 6315497d5..cab813350 100644 --- a/content/shared/influxctl/database/list.md +++ b/content/shared/influxctl/database/list.md @@ -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)._ diff --git a/content/shared/influxctl/release-notes.md b/content/shared/influxctl/release-notes.md index 686a3823b..8e20ec8be 100644 --- a/content/shared/influxctl/release-notes.md +++ b/content/shared/influxctl/release-notes.md @@ -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 diff --git a/content/shared/influxctl/table/list.md b/content/shared/influxctl/table/list.md index b839ebfb8..1116d7d9b 100644 --- a/content/shared/influxctl/table/list.md +++ b/content/shared/influxctl/table/list.md @@ -16,10 +16,11 @@ influxctl table list [flags] ## 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)._ diff --git a/content/shared/influxctl/table/undelete.md b/content/shared/influxctl/table/undelete.md new file mode 100644 index 000000000..0890eabde --- /dev/null +++ b/content/shared/influxctl/table/undelete.md @@ -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 + + + +```bash +influxctl table undelete +``` + +## 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: +> +> +> +> ```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 %}} diff --git a/data/products.yml b/data/products.yml index 427263539..9dc315394 100644 --- a/data/products.yml +++ b/data/products.yml @@ -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?