Skip to content

Conversation

@jstirnaman
Copy link
Contributor

@jstirnaman jstirnaman commented Dec 4, 2025

Summary

  • Fix clause order: FUTURE LIMIT must appear before PAST LIMIT (parser requirement)
  • Add FUTURE LIMIT and PAST LIMIT clauses to ALTER RETENTION POLICY syntax documentation
  • Add grammar definitions for retention_future_limit and retention_past_limit
  • Add explicit note clarifying the required clause order
  • Clean up InfluxQL spec formatting (separate commit)

Files changed

Retention policy fixes

  • content/influxdb/v1/query_language/manage-database.md
  • content/enterprise_influxdb/v1/query_language/manage-database.md
  • content/influxdb/v1/query_language/spec.md
  • content/enterprise_influxdb/v1/query_language/spec.md

Test plan

  • Hugo build passes
  • Review rendered pages for correct syntax display

closes #6590

…d add to ALTER RETENTION POLICY

- Fix clause order: FUTURE LIMIT must appear before PAST LIMIT (parser requirement)
- Add FUTURE LIMIT and PAST LIMIT clauses to ALTER RETENTION POLICY syntax
- Add grammar definitions for retention_future_limit and retention_past_limit
- Add explicit note clarifying the required clause order
- Fix "There are" style issue in spec.md

closes #6590
influxdb/v1:
- Simplify introduction and use relative anchor links
- Convert notes to GitHub-style callout syntax
- Fix heading hierarchy (Letters/digits, Identifiers, Keywords, Literals as h3)
- Standardize Duration units table heading
- Fix "keywords" typo
- Reword "See FAQ" to "For more information, see"
- Simplify KILL QUERY section
- Fix SHOW MEASUREMENT CARDINALITY heading level
- Replace "There are" with active voice

enterprise_influxdb/v1:
- Add related links to frontmatter
- Simplify introduction and use relative anchor links
- Convert notes to GitHub-style callout syntax
- Add Characters and Letters/digits to TOC
- Standardize Duration units table heading
- Fix "keywords" typo
- Reword "See FAQ" to "For more information, see"
- Simplify KILL QUERY section for Enterprise clusters
- Update SHOW TAG KEYS grammar to include with_key_clause
- Remove backticks from SHOW STATS headings
show_stats_stmt = "SHOW STATS [ FOR '<component>' | 'indexes' ]"
```

#### `SHOW STATS`
Copy link
Contributor Author

@jstirnaman jstirnaman Dec 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Duplicate heading. I rearranged the content to be consistent with Ent.

- A multi-line comment begins with `/*` and ends with `*/`. This comment type can span several lines.
Multi-line comments do not support nested multi-line comments.

## Query Engine Internals
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you're looking for this in Ent., it has a separate Internals page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CREATE RETENTION and ALTER RETENTION for V1 have errors around LIMIT clauses

3 participants