docs-v2/content/shared/sql-reference/functions
Jason Stirnaman ec70614a4e
docs(sql): add LAG examples for time-based value comparisons (#6577)
* chore(sql): add LAG examples for time-based value comparisons

Enhance window function documentation with practical examples for
calculating differences between current and previous values (e.g., 1h ago).

- Add 3 LAG examples to window functions reference with tested queries
- Create new 'Compare values' query guide covering common time-based
  comparison patterns (differences, percentage changes, exact intervals)
- Add guide frontmatter for all InfluxDB 3 products

All queries validated against InfluxDB 3 Core.

Refs: Kapa.ai conversation https://app.kapa.ai/720100f9-ce93-4305-88fd-5fcf71effad7/conversations/4536b79e-3930-4359-87f5-2ad9ccc1917d
Starting from: https://docs.influxdata.com/influxdb3/cloud-serverless/reference/sql/functions/window/

* chore(sql): add counter metrics examples to compare-values guide

Enhance time-based value comparisons with counter metrics patterns
using LAG and GREATEST to handle counter resets.

- Add counter metrics section with 3 examples (rate, cumulative, intervals)
- Include tested queries for non-negative differences and aggregation
- Document workarounds for Flux increase() and InfluxQL NON_NEGATIVE_DIFFERENCE()

All queries validated against InfluxDB 3 Core.

Refs: Kapa.ai conversation https://app.kapa.ai/720100f9-ce93-4305-88fd-5fcf71effad7/conversations/16b13679-0ced-4780-ab58-3d9cacb2d899
Starting from: https://docs.influxdata.com/influxdb3/enterprise/

* Update content/shared/influxdb3-query-guides/sql/compare-values.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2025-12-01 15:14:44 -06:00
..
_index.md Consolidate SQL reference docs (#5712) 2024-12-16 13:08:14 -07:00
aggregate.md chore(sql): adds new syntax for sql approx functions (#6402) 2025-10-02 16:15:38 -06:00
array.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
binary-string.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
cache.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
conditional.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
hashing.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
map.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
math.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
misc.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
regular-expression.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
selector.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
string.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
struct.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
time-and-date.md chore(sql): Update SQL reference with additional functions (#6359) 2025-09-05 08:26:38 -06:00
window.md docs(sql): add LAG examples for time-based value comparisons (#6577) 2025-12-01 15:14:44 -06:00