docs: document TQL CTE support in CREATE FLOW#2405
Closed
Conversation
Copilot
AI
changed the title
[WIP] Update documentation for feat: flow tql cte
docs: document TQL CTE support in CREATE FLOW
Apr 9, 2026
discord9
approved these changes
Apr 20, 2026
Contributor
discord9
left a comment
There was a problem hiding this comment.
if diff is actually added then LGTM
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the new TQL CTE pattern for
CREATE FLOWintroduced in GreptimeTeam/greptimedb#7702, which allows wrappingTQL EVALin a CTE for cleaner flow definitions and stable output column names.What's Changed in this PR
docs/user-guide/flow-computation/continuous-aggregation.md— Added "Wrapping TQL with a CTE" section covering syntax, use case (column renaming before sink table schema inference), and supported shape restrictionsdocs/reference/sql/create.md— Extended CREATE FLOW section with the TQL CTE form and its strict shape requirementsdocs/user-guide/query-data/cte.md— Added key point noting that TQL CTEs inCREATE FLOWonly support the simplest form (single CTE +SELECT *)i18n/zh/(Chinese) andversioned_docs/version-1.0/The supported syntax:
Restrictions: exactly one TQL CTE, outer query must be
SELECT * FROM <cte-name>, no WHERE/joins/projections/extra CTEs. Quoted CTE names must be referenced consistently.Checklist
sidebars.tsmatches the current document structure when you changed the document structure.