From 5b37cb7eba353b3ad43fa9c3efb9a84d02c76e00 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Tue, 2 Dec 2025 13:24:00 -0500 Subject: [PATCH] fix(clustered): use "database" instead of "namespace" in release notes (#6583) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(influxdb3): Use the CLI (influxdb3 --version), /ping endpoint, or /health endpoint to get the actual InfluxDB product version—not the SQL version() function. Summary of Changes 1. content/shared/sql-reference/functions/misc.md (SQL version() function) - Enhanced the description to clarify it returns the DataFusion query engine version - Added a Note callout explicitly stating this is NOT the InfluxDB product version - Added a link to the identify-version page for users who want to find their InfluxDB version - Added an expandable example with the actual query and output: SELECT version() - Output: Apache DataFusion 49.0.2, aarch64 on linux 2. content/shared/identify-version.md (Identify version page) Added a Note callout in three locations: - Core-specific section (show-in "core") - Enterprise-specific section (show-in "enterprise") - General InfluxDB 3 Core and Enterprise section (in the tabs) Replaced hardcoded patch version with latest-version shortcode * fix(clustered): use "database" instead of "namespace" in release notes Replace user-facing "namespace" terminology with "database" in the Clustered release notes for clarity. Add a note explaining that "namespace" in environment variable names refers to a database. closes influxdata/DAR#556 --- .../reference/release-notes/clustered.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/content/influxdb3/clustered/reference/release-notes/clustered.md b/content/influxdb3/clustered/reference/release-notes/clustered.md index dd2775fff..939df219f 100644 --- a/content/influxdb3/clustered/reference/release-notes/clustered.md +++ b/content/influxdb3/clustered/reference/release-notes/clustered.md @@ -82,14 +82,18 @@ spec: Tables can now be renamed and undeleted with [influxctl v2.10.5](https://docs.influxdata.com/influxdb3/clustered/reference/release-notes/influxctl/#2105) or later. -To enable hard delete of soft-deleted namespaces: -- Set `INFLUXDB_IOX_ENABLE_NAMESPACE_ROW_DELETION` to `true`. - - If needed, adjust how long a namespace remains soft-deleted (and eligible for undeletion) by setting `INFLUXDB_IOX_GC_NAMESPACE_CUTOFF` (default: `14d`) - - If needed, adjust how long the garbage collector should sleep between runs of the namespace deletion task with `INFLUXDB_IOX_GC_NAMESPACE_SLEEP_INTERVAL` The default is `24h` which should be suitable for ongoing cleanup, but if there is a backlog of soft-deleted namespaces to clean up, you may want to run this more frequently until the garbage collector has caught up. - - If needed, adjust the maximum number of namespaces that will get hard deleted in one run of the namespace deletion task with `INFLUXDB_IOX_GC_NAMESPACE_LIMIT` The default is `1000` which should be suitable for ongoing cleanup, but if you have a large number of namespaces and you're running the task very frequently, you may need to lower this to delete fewer records per run if each individual run is timing out. +To enable hard delete of soft-deleted databases: -To enable hard delete of soft-deleted tables in active namespaces (soft-deleted tables in soft-deleted namespaces get cleaned up when the namespace gets cleaned up): -- Set `INFLUXDB_IOX_ENABLE_TABLE_ROW_DELETION` to `true`, and if needed, adjust these settings that work in the same way as the corresponding namespace flags: +> [!Note] +> In {{% product-name %}}, "namespace" in environment variable names refers to a database. + +- Set `INFLUXDB_IOX_ENABLE_NAMESPACE_ROW_DELETION` to `true`. + - If needed, adjust how long a database remains soft-deleted (and eligible for undeletion) by setting `INFLUXDB_IOX_GC_NAMESPACE_CUTOFF` (default: `14d`) + - If needed, adjust how long the garbage collector should sleep between runs of the database deletion task with `INFLUXDB_IOX_GC_NAMESPACE_SLEEP_INTERVAL` The default is `24h` which should be suitable for ongoing cleanup, but if there is a backlog of soft-deleted databases to clean up, you may want to run this more frequently until the garbage collector has caught up. + - If needed, adjust the maximum number of databases that will get hard deleted in one run of the database deletion task with `INFLUXDB_IOX_GC_NAMESPACE_LIMIT` The default is `1000` which should be suitable for ongoing cleanup, but if you have a large number of databases and you're running the task very frequently, you may need to lower this to delete fewer records per run if each individual run is timing out. + +To enable hard delete of soft-deleted tables in active databases (soft-deleted tables in soft-deleted databases get cleaned up when the database gets cleaned up): +- Set `INFLUXDB_IOX_ENABLE_TABLE_ROW_DELETION` to `true`, and if needed, adjust these settings that work in the same way as the corresponding database flags: - `INFLUXDB_IOX_GC_TABLE_CUTOFF` (default: `14d`) - `INFLUXDB_IOX_GC_TABLE_SLEEP_INTERVAL` (default: `24h`) - `INFLUXDB_IOX_GC_TABLE_LIMIT` (default: `1000`)