Merge branch 'master' into garylfowler-patch-4

Author: jstirnaman

.ci/vale/styles/config/vocabularies/InfluxDataDocs/accept.txt

@@ -31,7 +31,7 @@ LogicalPlan
 [Mm]onitor
 MBs?
 PBs?
-Parquet
+Parquet|\b\w*-*parquet-\w*\b|\b--\w*parquet\w*\b|`[^`]*parquet[^`]*`
 Redoc
 SQLAlchemy
 SQLAlchemy

.husky/_/pre-commit

@@ -33,9 +33,6 @@ call_lefthook()
     then
       "$dir/node_modules/lefthook/bin/index.js" "$@"
 
-    elif go tool lefthook -h >/dev/null 2>&1
-    then
-      go tool lefthook "$@"
     elif bundle exec lefthook -h >/dev/null 2>&1
     then
       bundle exec lefthook "$@"
@@ -45,21 +42,12 @@ call_lefthook()
     elif pnpm lefthook -h >/dev/null 2>&1
     then
       pnpm lefthook "$@"
-    elif swift package lefthook >/dev/null 2>&1
+    elif swift package plugin lefthook >/dev/null 2>&1
     then
-      swift package --build-path .build/lefthook --disable-sandbox lefthook "$@"
+      swift package --disable-sandbox plugin lefthook "$@"
     elif command -v mint >/dev/null 2>&1
     then
       mint run csjones/lefthook-plugin "$@"
-    elif uv run lefthook -h >/dev/null 2>&1
-    then
-      uv run lefthook "$@"
-    elif mise exec -- lefthook -h >/dev/null 2>&1
-    then
-      mise exec -- lefthook "$@"
-    elif devbox run lefthook -h >/dev/null 2>&1
-    then
-      devbox run lefthook "$@"
     else
       echo "Can't find lefthook in PATH"
     fi

.husky/_/pre-push

@@ -33,9 +33,6 @@ call_lefthook()
     then
       "$dir/node_modules/lefthook/bin/index.js" "$@"
 
-    elif go tool lefthook -h >/dev/null 2>&1
-    then
-      go tool lefthook "$@"
     elif bundle exec lefthook -h >/dev/null 2>&1
     then
       bundle exec lefthook "$@"
@@ -45,21 +42,12 @@ call_lefthook()
     elif pnpm lefthook -h >/dev/null 2>&1
     then
       pnpm lefthook "$@"
-    elif swift package lefthook >/dev/null 2>&1
+    elif swift package plugin lefthook >/dev/null 2>&1
     then
-      swift package --build-path .build/lefthook --disable-sandbox lefthook "$@"
+      swift package --disable-sandbox plugin lefthook "$@"
     elif command -v mint >/dev/null 2>&1
     then
       mint run csjones/lefthook-plugin "$@"
-    elif uv run lefthook -h >/dev/null 2>&1
-    then
-      uv run lefthook "$@"
-    elif mise exec -- lefthook -h >/dev/null 2>&1
-    then
-      mise exec -- lefthook "$@"
-    elif devbox run lefthook -h >/dev/null 2>&1
-    then
-      devbox run lefthook "$@"
     else
       echo "Can't find lefthook in PATH"
     fi

.husky/_/prepare-commit-msg

@@ -33,9 +33,6 @@ call_lefthook()
     then
       "$dir/node_modules/lefthook/bin/index.js" "$@"
 
-    elif go tool lefthook -h >/dev/null 2>&1
-    then
-      go tool lefthook "$@"
     elif bundle exec lefthook -h >/dev/null 2>&1
     then
       bundle exec lefthook "$@"
@@ -45,21 +42,12 @@ call_lefthook()
     elif pnpm lefthook -h >/dev/null 2>&1
     then
       pnpm lefthook "$@"
-    elif swift package lefthook >/dev/null 2>&1
+    elif swift package plugin lefthook >/dev/null 2>&1
     then
-      swift package --build-path .build/lefthook --disable-sandbox lefthook "$@"
+      swift package --disable-sandbox plugin lefthook "$@"
     elif command -v mint >/dev/null 2>&1
     then
       mint run csjones/lefthook-plugin "$@"
-    elif uv run lefthook -h >/dev/null 2>&1
-    then
-      uv run lefthook "$@"
-    elif mise exec -- lefthook -h >/dev/null 2>&1
-    then
-      mise exec -- lefthook "$@"
-    elif devbox run lefthook -h >/dev/null 2>&1
-    then
-      devbox run lefthook "$@"
     else
       echo "Can't find lefthook in PATH"
     fi

content/influxdb3/cloud-dedicated/admin/tables/rename.md

@@ -0,0 +1,44 @@
+---
+title: Rename a table
+description: >
+  Use the [`influxctl table rename` command](/influxdb3/cloud-dedicated/reference/cli/influxctl/table/rename/)
+  to rename a table in your {{< product-name omit=" Cluster" >}} cluster.
+menu:
+  influxdb3_cloud_dedicated:
+    parent: Manage tables
+weight: 202
+list_code_example: |
+  ##### CLI
+  ```sh
+  influxctl table rename <DATABASE_NAME> <CURRENT_TABLE_NAME> <NEW_TABLE_NAME>
+  ```
+related:
+  - /influxdb3/cloud-dedicated/reference/cli/influxctl/table/rename/
+---
+
+Use the [`influxctl table rename` command](/influxdb3/cloud-dedicated/reference/cli/influxctl/table/rename/)
+to rename a table in your {{< product-name omit=" Clustered" >}} cluster.
+
+> [!Note]
+> After renaming a table, write and query requests using the old table name
+> are routed to the same table.
+
+## Rename a database using the influxctl CLI
+
+<!-- pytest.mark.skip -->
+
+```bash { placeholders="DATABASE_NAME|CURRENT_TABLE_NAME|NEW_TABLE_NAME" }
+influxctl table rename DATABASE_NAME CURRENT_TABLE_NAME NEW_TABLE_NAME
+```
+
+Replace the following:
+
+- {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}: Name of the database the table is in
+- {{% code-placeholder-key %}}`CURRENT_TABLE_NAME`{{% /code-placeholder-key %}}: Name of the table to change
+- {{% code-placeholder-key %}}`NEW_TABLE_NAME`{{% /code-placeholder-key %}}: New name for the table
+
+> [!Note]
+> #### Renamed table retains its ID
+> 
+> The table ID remains the same after renaming. When you list tables,
+> you'll see the new name associated with the original table ID.

content/influxdb3/cloud-dedicated/query-data/execute-queries/client-libraries/python.md

@@ -26,6 +26,7 @@ related:
     - /influxdb3/cloud-dedicated/reference/influxql/
     - /influxdb3/cloud-dedicated/reference/sql/
     - /influxdb3/cloud-dedicated/query-data/execute-queries/troubleshoot/
+    - /influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-timeout-best-practices/
 
 list_code_example: |
     ```py
@@ -240,7 +241,8 @@ from influxdb_client_3 import InfluxDBClient3
 client = InfluxDBClient3(
     host='{{< influxdb/host >}}',
     token='DATABASE_TOKEN',
-    database='DATABASE_NAME'
+    database='DATABASE_NAME',
+    timeout=60  # Set default timeout to 60 seconds
 )
 ```
 {{% /code-placeholders %}}
@@ -275,6 +277,7 @@ client = InfluxDBClient3(
 host="{{< influxdb/host >}}",
 token='DATABASE_TOKEN',
 database='DATABASE_NAME',
+timeout=60,  # Set default timeout to 60 seconds
 flight_client_options=flight_client_options(
 tls_root_certs=cert))
 ...
@@ -332,7 +335,8 @@ client = InfluxDBClient3(
 # Execute the query and return an Arrow table
 table = client.query(
     query="SELECT * FROM home",
-    language="sql"
+    language="sql",
+    timeout=30  # Override default timeout for simple queries (30 seconds)
 )
 
 print("\n#### View Schema information\n")
@@ -377,7 +381,8 @@ client = InfluxDBClient3(
 # Execute the query and return an Arrow table
 table = client.query(
     query="SELECT * FROM home",
-    language="influxql"
+    language="influxql",
+    timeout=30  # Override default timeout for simple queries (30 seconds)
 )
 
 print("\n#### View Schema information\n")

content/influxdb3/cloud-dedicated/query-data/execute-queries/influxctl-cli.md

@@ -13,6 +13,7 @@ influxdb3/cloud-dedicated/tags: [query, sql, influxql, influxctl, CLI]
 related:
   - /influxdb3/cloud-dedicated/reference/cli/influxctl/query/
   - /influxdb3/cloud-dedicated/get-started/query/#execute-an-sql-query, Get started querying data
+  - /influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-timeout-best-practices/, Query timeout best practices
   - /influxdb3/cloud-dedicated/reference/sql/
   - /influxdb3/cloud-dedicated/reference/influxql/
 list_code_example: |
@@ -142,6 +143,34 @@ Replace the following:
 - {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}:
   Name of the database to query
 
+## Query timeouts
+
+The [`influxctl --timeout` global flag](/influxdb3/cloud-dedicated/reference/cli/influxctl/) sets the maximum duration for API calls, including query requests.
+If a query takes longer than the specified timeout, the operation will be canceled.
+
+### Timeout examples
+
+Use different timeout values based on your query type:
+
+{{% code-placeholders "DATABASE_(TOKEN|NAME)" %}}
+```sh
+# Shorter timeout for testing dashboard queries (10 seconds)
+influxctl query \
+  --timeout 10s \
+  --token DATABASE_TOKEN \
+  --database DATABASE_NAME \
+  "SELECT AVG(temperature) FROM sensors WHERE time >= now() - INTERVAL '1 day'"
+
+# Longer timeout for analytical queries (5 minutes)
+influxctl query \
+  --timeout 5m \
+  --token DATABASE_TOKEN \
+  --database DATABASE_NAME \
+  "SELECT room, AVG(temperature) FROM sensors WHERE time >= now() - INTERVAL '30 days' GROUP BY room"
+```
+{{% /code-placeholders %}}
+
+For guidance on selecting appropriate timeout values, see [Query timeout best practices](/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-timeout-best-practices/).
 
 ## Output format
 
@@ -243,7 +272,7 @@ influxctl query \
 {{% /influxdb/custom-timestamps %}}
 
 {{< expand-wrapper >}}
-{{% expand "View example results with unix nanosecond timestamps" %}}
+{{% expand "View example results with Unix nanosecond timestamps" %}}
 {{% influxdb/custom-timestamps %}}
 ```
 +-------+--------+---------+------+---------------------+

content/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-timeout-best-practices.md

@@ -0,0 +1,17 @@
+---
+title: Query timeout best practices
+description: Learn how to set appropriate query timeouts to balance performance and resource protection.
+menu:
+  influxdb3_cloud_dedicated:
+    name: Query timeout best practices
+    parent: Troubleshoot and optimize queries
+weight: 205
+related:
+  - /influxdb3/cloud-dedicated/reference/client-libraries/v3/
+  - /influxdb3/cloud-dedicated/query-data/execute-queries/influxctl-cli/
+source: shared/influxdb3-query-guides/query-timeout-best-practices.md
+---
+
+<!--
+//SOURCE - content/shared/influxdb3-query-guides/query-timeout-best-practices.md
+>

content/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/troubleshoot.md

@@ -12,6 +12,7 @@ related:
   - /influxdb3/cloud-dedicated/query-data/sql/
   - /influxdb3/cloud-dedicated/query-data/influxql/
   - /influxdb3/cloud-dedicated/reference/client-libraries/v3/
+  - /influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-timeout-best-practices/
 aliases:
   - /influxdb3/cloud-dedicated/query-data/execute-queries/troubleshoot/
   - /influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/trace/
@@ -30,7 +31,9 @@ If a query doesn't return any data, it might be due to the following:
 
 - Your data falls outside the time range (or other conditions) in the query--for example, the InfluxQL `SHOW TAG VALUES` command uses a default time range of 1 day.
 - The query (InfluxDB server) timed out.
-- The query client timed out.
+- The query client timed out. 
+  See [Query timeout best practices](/influxdb3/cloud-dedicated/query-data/troubleshoot-and-optimize/query-timeout-best-practices/) 
+  for guidance on setting appropriate timeouts.
 - The query return type is not supported by the client library.
   For example, array or list types may not be supported.
   In this case, use `array_to_string()` to convert the array value to a string--for example:

content/influxdb3/cloud-dedicated/reference/cli/influxctl/table/rename.md

@@ -0,0 +1,14 @@
+---
+title: influxctl table rename
+description: >
+  The `influxctl table rename` command renames a table in an
+  {{% product-name omit=" Clustered" %}} cluster.
+menu:
+  influxdb3_cloud_dedicated:
+    parent: influxctl table
+weight: 301
+metadata: [influxctl 2.10.3+]
+source: /shared/influxctl/table/rename.md
+---
+
+<!-- //SOURCE content/shared/influxctl/table/rename.md -->