From b95e608d07cd86ae5111f5fe600748a84e206671 Mon Sep 17 00:00:00 2001
From: Jason Stirnaman <jstirnaman@influxdata.com>
Date: Mon, 1 Dec 2025 17:02:25 -0500
Subject: [PATCH] =?UTF-8?q?docs(influxdb3):=20Use=20the=20CLI=20(influxdb3?=
 =?UTF-8?q?=20--version),=20/ping=20endpoint,=20or=20/health=20endpoint=20?=
 =?UTF-8?q?to=20get=20the=20actual=20InfluxDB=20product=20version=E2=80=94?=
 =?UTF-8?q?not=20the=20SQL=20version()=20function.=20(#6579)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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
---
 content/shared/identify-version.md            | 25 +++++++++++++++++--
 .../shared/sql-reference/functions/misc.md    | 24 +++++++++++++++++-
 2 files changed, 46 insertions(+), 3 deletions(-)

diff --git a/content/shared/identify-version.md b/content/shared/identify-version.md
index 2a76b35ff..780f91346 100644
--- a/content/shared/identify-version.md
+++ b/content/shared/identify-version.md
@@ -70,7 +70,7 @@ curl -i http://localhost:8181/ping
 
 Look for:
 
-- `x-influxdb-version`: Version number (for example, `3.6.0`)
+- `x-influxdb-version`: Version number (for example, {{% latest-patch %}})
 - `x-influxdb-build`: `Core`
 
 {{% /show-in %}}
@@ -99,9 +99,10 @@ curl -i http://localhost:8181/ping
 
 Look for:
 
-- `x-influxdb-version`: Version number (for example, `3.6.0`)
+- `x-influxdb-version`: Version number (for example, {{% latest-patch %}})
 - `x-influxdb-build`: `Enterprise`
 
+
 {{% /show-in %}}
 
 {{% show-in "clustered" %}}
@@ -155,6 +156,17 @@ influxctl cluster list
 
 {{% /show-in %}}
 
+{{% hide-in "v2,cloud,v1" %}}
+> [!Note]
+>
+> #### SQL version() function
+>
+> The SQL `version()` function returns the
+> [DataFusion](https://datafusion.apache.org/) query engine version, not the
+> InfluxDB product version. Use the methods above to identify your InfluxDB
+> version.
+{{% /hide-in %}}
+
 {{% show-in "v2" %}}
 
 ### InfluxDB OSS v2 detection
@@ -272,6 +284,15 @@ Look for:
 - `x-influxdb-version`: Version number (for example, `3.6.0`)
 - `x-influxdb-build`: `Core` or `Enterprise`
 
+> [!Note]
+>
+> #### SQL version() function
+>
+> The SQL `version()` function returns the
+> [DataFusion](https://datafusion.apache.org/) query engine version, not the
+> InfluxDB product version. Use the methods above to identify your InfluxDB
+> version.
+
 {{% /tab-content %}}
 
 {{< /tabs-wrapper >}}
diff --git a/content/shared/sql-reference/functions/misc.md b/content/shared/sql-reference/functions/misc.md
index 2623e432a..1cd35ecbb 100644
--- a/content/shared/sql-reference/functions/misc.md
+++ b/content/shared/sql-reference/functions/misc.md
@@ -268,8 +268,30 @@ GROUP BY _time, room
 
 ## version
 
-Returns the version of DataFusion.
+Returns the version of [DataFusion](https://datafusion.apache.org/) used by the query engine.
+
+> [!Note]
+>
+> The `version()` function returns the DataFusion query engine version, not the
+> InfluxDB product version.
+> To identify your InfluxDB version, see [Identify version](/influxdb3/version/admin/identify-version/).
 
 ```sql
 version()
 ```
+
+{{< expand-wrapper >}}
+{{% expand "View `version` query example" %}}
+
+```sql
+SELECT version()
+```
+
+| version()                                  |
+| :----------------------------------------- |
+| Apache DataFusion 49.0.2, aarch64 on linux |
+
+The output includes the DataFusion version, CPU architecture, and operating system.
+
+{{% /expand %}}
+{{< /expand-wrapper >}}