SQL GA#570
Merged
Merged
Conversation
✅ Deploy Preview for rp-cloud ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
|
Important Review skippedAuto incremental reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
📝 WalkthroughWalkthroughAdds a comprehensive Redpanda SQL documentation set and navigation. New pages cover SQL statements, clauses (FROM/JOIN/GROUP BY/etc.), data types (numeric, temporal, JSON, arrays, geo, row), functions (aggregate, window, boolean, math, string, JSON, timestamp, other), operators (including bitwise), information schema, schema, and supporting references. Updates the global nav to surface these sections and adds a “What’s new” entry for Redpanda SQL in May 2026. Sequence Diagram(s)(skip) Estimated code review effort🎯 4 (Complex) | ⏱️ ~90 minutes Suggested reviewers
✨ Finishing Touches🧪 Generate unit tests (beta)
|
* Add converted SQL reference files
* Duplicate file
* Add index files
* Add SQL reference to Cloud nav
* Move reference pages to reference module
* Convert remaining docs
* Add placeholder index files
* Cleanup
* Move SQL section after RPCN
* Continue cleanup using plugin audit and review
* External links open in new window
* Minor edit to trigger deploy preview
* Migrate degraded state doc
* Minor style edits
* Address drift from Oxla changes since mid-Oct 2025
* Include CREATE TABLE and DROP changes
* Update existing pages with placeholders for pages to be created
* Another pass at style fixes
* Missing TODO
* Add remaining new reference pages to address doc drift
* Remove Oxla storage compression references
* Remove INSERT/UPDATE/DELETE from psycopg2 supported features
* Remove Oxla-specific reasons from java-jdbc unsupported list
* Remove DELETE/UPDATE references from php-pdo rowCount
* Remove CREATE TABLE/INSERT example from select.adoc
Assume that a student_data table is already created and populated with data
* Remove table duplication TIP
* Fix clumped "SELECTstatement"
* Add missing Venn diagrams to JOIN pages
* Inconsistent formatting with function names and parentheses
* Incorrect COUNT logic with HAVING
* Add NULLS FIRST/LAST, fix interval sorting
* Replace CREATE TABLE oxlafunctions example in offset.adoc
Redpanda SQL does not support CREATE TABLE without an external catalog
Example assumes precreated salaryemp table
* Unrelated "employees" text
* Move column compatibility note to set-operations index
Column type compatibility and flexible ordering
applies to all set operations (UNION, INTERSECT, EXCEPT)
* Both ROWS and RANGE frame modes are supported
* Add GEOMETRY/GEOGRAPHY
* Create sql-operators section with full operator list
* timestamp-with-time-zone formatting
* Remove internal memory representation for date type
* Add month and day conversion note
* Remove internal memory representation from bool type
* System catalogs disambiguation note and 7 new pg_* pages
* Fix nav
* Move bitwise operators
* Double check SQL examples and outputs
* Remove unix_macros
* Reorganize math and trig function pages
* Implement some deferred fixes related to old Oxla examples
* Fix anchors in xrefs
* Apply QA checklist first pass across SQL reference docs
Run 11-point QA checklist against all migrated SQL pages (148 files).
Fixes applied: remove "Please note" phrasing, fix "here" link text,
replace future tense output descriptions with present tense, simplify
"allows/enables you to" constructions, remove minimizing language,
fix wordy instructions, add missing admonition punctuation, replace
verbose output lead-ins, remove "etc.", normalize positional references,
and update stale PostgreSQL doc links to /docs/current/.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* Person 4 edits, including future tense, passive voice
* more Person 4 edits
* Person 4 edits
* Parallelize :description: metadata for SQL language client pages
Standardize the Java, PHP, and Python connector pages on the same
imperative "Connect to Redpanda SQL from <language> using <tool>"
template already used by the C# page and the parent index page.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* Apply Feediver1 review suggestions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Apply pending PR suggestion comments
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Minor edit - statements index
* keywords.adoc - move in nav tree, make table more scannable
* alter-table minor edit
* create-redpanda-catalog: Improve Options section
* create-storage minor edit
* Improve CREATE TABLE reference page clarity
Clarify NOTE about CREATE TABLE behavior, convert multi-value option
descriptions to lists for scannability, and rename ambiguous example
heading.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* select: review fixes
* set-show: review fixes
* show-tables minor edit
* show-nodes: review fixes
* describe: review fixes
* sql-statements review pass
* from - review pass
* Minor edit
* set-operations: review fixes
* More review fixes for sql-clauses
* other-functions review fixes
* Normalize QA fixes
* Apply edits based on doc team review
* Standardize "To do X, run:"
* Structural improvements
* Sweep for passive voice
* Person 2 style review: aggregate, window, JSON functions
Style fixes across 31 files:
- Future tense → present tense ("will return" → "returns")
- Wordy instructions ("lets you" → direct verb)
- Awkward phrasing ("Here's how" → cleaner alternatives)
- First person ("we're going to" → "This example")
- Passive "It" patterns in tables → active voice
- Positional references ("the above query" → "Output:")
- Typo fix ("ouput" → "output")
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Pass to standardize QA
* Apply suggestions from review
* Minor edits
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: micheleRP <michele@redpanda.com>
Co-authored-by: Joyce Fee <joyce@redpanda.com>
Co-authored-by: JakeSCahill <jake@redpanda.com>
* SQL GA nav * DOC-1993: Move Redpanda Catalogs page to sql module under Query data Relocates redpanda-catalogs.adoc from modules/reference/pages/sql/ to modules/sql/pages/query-data/, adds the entry under SQL > Query data in nav.adoc, removes the old entry from Reference > Redpanda SQL Reference, and updates the cross-link in system-catalogs/index.adoc. Structural-only; no content changes (content rewrite is in DOC-2049). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* Add bytea reference * Apply suggestions from SME review * Update modules/reference/pages/sql/sql-data-types/bytea.adoc Co-authored-by: Michele Cyran <michele@redpanda.com> * Apply suggestions from doc review * Reorganize SQL reference nav --------- Co-authored-by: Michele Cyran <michele@redpanda.com>
* Draft SQL overview rewrite * DOC-2049: Apply v1 Iceberg scope and Postgres positioning to overview and catalogs Tightens the PostgreSQL framing in the overview (compatible query engine implementing the Postgres wire protocol and a Postgres-based dialect, not a full Postgres database). Aligns Iceberg references with the v1 product scope: only Iceberg tables created from Iceberg-enabled Redpanda topics are queryable; no external Iceberg lakehouses or REST catalogs. Collapses the overview's "Query Iceberg tables" and "Bridge queries" sections into "Query Iceberg topics". Rewrites the Redpanda Catalogs page with the named-collection-of-source-data framing, leads with default_redpanda_connection auto-creation, and adds a storage > catalog > tables hierarchy. Replaces the prior CREATE-flow walkthrough with a smaller demo using default_redpanda_connection. Per PM SME 2026-05-07. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Add TODO to flesh out sql v pg * Move why RP SQL up * Minor edits * Review pass * Change to default_redpanda_catalog * Tweak overview learning objectives * Review pass * Intro rephrase * Remove tables not describing meaningful differences with Postgres * Clarify Iceberg benefit of querying data outside of topic retention * Minor edit * Apply suggestions from SME feedback * Apply suggestions from PM review * Minor edit * Apply suggestions from code review Co-authored-by: Michele Cyran <michele@redpanda.com> * Apply suggestions from review --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com> Co-authored-by: Michele Cyran <michele@redpanda.com>
* Add quickstart draft * Add deploy doc (use case 1) * Add to nav * Remove create kafka source * Move show/inspect statements to deploy doc * DOC-1856: Apply 9-node scale cap, admin framing, and GRANT mini-step Updates the Enable Redpanda SQL page so the horizontal-scaling range is 1 to 9 nodes (down from 1 to 12) per the PM SME 2026-05-07. Adds a TODO on the Disable Redpanda SQL section listing the specific behaviors to confirm with engineering before publication: what state is purged, what is deleted from object storage, the effect on topic and Schema Registry data, in-flight query error behavior, and re-enable semantics. Updates the quickstart so it explicitly targets an admin who can view the SQL connection details in the Cloud Console, and adds an optional admin-run mini-section showing how to grant a non-admin user SELECT access on a Redpanda SQL table. Includes a TODO referencing qa-questions.md #21 to refine the role/grant example once engineering confirms whether the SQL GRANT statement alone enforces per-user table access or whether an additional ACL/Kafka-side step is required. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Update modules/sql/pages/get-started/sql-quickstart.adoc Co-authored-by: Andrew Hsu <xuzuan@gmail.com> * Change quickstart path to use UI to produce instead of rpk * Add deployment/connection UI updates * Apply suggestions from SME * Review pass * Add wire protocol option when producing via Console * Edits per SME input * Apply suggestions from SME review * Use JSON in quickstart * Add SQL deployment UI changes * schema subject is optional (default to topic name strategy) * Apply suggestions from code review Co-authored-by: Joyce Fee <102751339+Feediver1@users.noreply.github.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com> Co-authored-by: Andrew Hsu <xuzuan@gmail.com> Co-authored-by: Joyce Fee <102751339+Feediver1@users.noreply.github.com>
* Draft OIDC content * Update draft with source findings and TODO * Review pass * Review pass * Add reference docs for GRANT, REVOKE, ROLE/USER * Preference for USER instead of ROLE * Review pass * Move Connect with OIDC up in nav * Clarify "deny-all" * Change name and title to broaden scope * Update user names * Add learning objectives * Apply suggestions from SME review * Apply suggestions from SME review * Review pass
* Start query RP topics doc * DOC-1990: Move query directory and rewrite streaming-topics how-to Renames modules/sql/pages/query/ to modules/sql/pages/query-data/ and renames the streaming-topic how-to from query-redpanda-topics.adoc to query-streaming-topics.adoc to match the SQL GA IA. Retitles the page "Query streaming topics" and reframes the description and learning objectives around live streaming data; bridge-query and Iceberg content stays out of this page (DOC-2006 owns the Iceberg-topics how-to). Adds a pointer to the Iceberg topics how-to under the intro and lists it under Next steps. Updates the enable-prereq xref to point to the Enable Redpanda SQL page. Drops the CREATE REDPANDA CATALOG link from Next steps to align with the v1 framing that users do not typically create their own Redpanda catalog. Reframes the Query data index page description for v1 Iceberg scope (live and historical data in Redpanda topics; no external Iceberg lakehouse). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Change rp connection to catalog * Add wire protocol option * schema_subject required * Review pass * Review pass * Address review comments * Add info on redpanda and redpanda_raw structs * Review pass * Adjust column widths --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* Start reference update for SQL / Iceberg catalog * Draft bridge queries doc * Update query-iceberg-topics per SME feedback * Add new iceberg catalog statements * Clarify Iceberg benefit of querying data aged out of topic retention * Links to Iceberg catalog docs * Update example names * Update based on new-features list * Sync options from source * Apply suggestions from SME feedback * Apply suggestions * Note about default schema * Update page title * Reframe per SME input * Remove TODO
* Draft struct support reference * How to query structs/nested fields * Review pass * Apply suggestions from SME review * Apply suggestions from SME review * Apply suggestions from code review Co-authored-by: Michele Cyran <michele@redpanda.com> * Review pass * Apply suggestions from code review Co-authored-by: Michele Cyran <michele@redpanda.com> * Apply suggestions --------- Co-authored-by: Michele Cyran <michele@redpanda.com>
* Start OOM doc draft * Review pass * Capitalization * Rename file * Update page attributes * Rename and structure doc per SME feedback * Apply suggestions from review * Apply suggestions from code review Co-authored-by: Michele Cyran <michele@redpanda.com> --------- Co-authored-by: Michele Cyran <michele@redpanda.com>
…ts (#590) * Expand virtual tables reference, add SHOW/DESCRIBE for new objects * Title case * Review pass * Apply suggestions from SME review * Fix nav * Apply suggestion from @micheleRP Co-authored-by: Michele Cyran <michele@redpanda.com> * Apply suggestions from review * Update modules/reference/pages/sql/information-schema.adoc Co-authored-by: Michele Cyran <michele@redpanda.com> * Apply suggestions from review --------- Co-authored-by: Michele Cyran <michele@redpanda.com>
* Built out SQL landing page * Add SQL to What's New in Cloud * Page title capitalization * Add catalog qualifier * Backticks pass * Edit landing page * Remove index auto page layout * Apply suggestions from code review Co-authored-by: Michele Cyran <michele@redpanda.com> * Apply suggestions from review; sweep * Update modules/get-started/pages/whats-new-cloud.adoc Co-authored-by: Michele Cyran <michele@redpanda.com> * Lowercase subsection headings and xref labels per PG convention - numeric.adoc: H2 subsections use backticked-lowercase type names (`int` type, `bigint` type, etc.) to match numeric-data-type-aliases.adoc. - create-table.adoc, query-nested-fields.adoc: xref labels for type pages (ROW, JSON) now use lowercase backticked form. - aggregate-functions/index.adoc, aggregate-functions/statistics/index.adoc, window-functions/index.adoc: function-name xref labels lowercased to backticked function-call form (sum() instead of SUM, regr_avgx() instead of REGR_AVGX, etc.). DISTINCT xref label preserved as uppercase (SQL keyword, not a function). - substring.adoc, position.adoc: cross-reference labels for substr and strpos lowercased. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * DOC-2207: Document SELECT DISTINCT Add a SELECT DISTINCT section to select.adoc covering the supported form and the unsupported PostgreSQL-specific DISTINCT ON form. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Minor edit * Consolidate substr and substring * Uppercase keyword-syntax and conditional functions per PG/CockroachDB convention Function-like operators that use SQL keyword syntax (EXTRACT, POSITION, SUBSTRING, SUBSTR) and conditional expressions (COALESCE, NULLIF, GREATEST, LEAST) get UPPERCASE in H1, body prose, and xref labels, matching how PostgreSQL and CockroachDB docs classify them. Regular call-syntax functions (sum, count, avg, abs, log, concat, length, etc.) stay lowercase. SQL keyword DISTINCT stays uppercase. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Add missing index page --------- Co-authored-by: Michele Cyran <michele@redpanda.com> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Actionable comments posted: 1
Note
Due to the large number of review comments, Critical severity comments were prioritized as inline comments.
🧹 Nitpick comments (5)
modules/reference/pages/sql/sql-functions/aggregate-functions/statistics/covar-pop.adoc (1)
18-19: ⚡ Quick winClarify parameter order semantics to avoid confusion.
The parameters are described as
y(predicted) andx(predictor), but the example usesCOVAR_POP(length, rating). Because covariance is symmetric this works, but the y/x framing implies directional meaning. Either make parameter descriptions neutral or align example/order with the description.Also applies to: 57-59
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@modules/reference/pages/sql/sql-functions/aggregate-functions/statistics/covar-pop.adoc` around lines 18 - 19, The parameter text currently frames the arguments as `y` (predicted) and `x` (predictor) but the example uses COVAR_POP(length, rating), causing semantic mismatch; either make the description neutral (e.g., "first variable" and "second variable" or "variable A / variable B") or change the example to match the y/x wording (e.g., COVAR_POP(rating, length)); apply the same change to the other occurrence referenced (lines ~57-59) so the `COVAR_POP` description and example are consistent.modules/reference/pages/sql/sql-functions/aggregate-functions/statistics/var-samp.adoc (1)
57-66: ⚡ Quick winMake alias casing consistent with shown output
At Line 57,
AS LengthSampleVariance(unquoted) folds to lowercase, matching Line 66. To reduce reader confusion, either quote the alias or use lowercase in the query.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@modules/reference/pages/sql/sql-functions/aggregate-functions/statistics/var-samp.adoc` around lines 57 - 66, The alias "LengthSampleVariance" in the VAR_SAMP(length) expression is unquoted and will be folded to lowercase (shown as lengthsamplevariance), so make casing consistent by either quoting the alias or using a lowercase alias; update the expression VAR_SAMP(length) AS LengthSampleVariance to either VAR_SAMP(length) AS "LengthSampleVariance" or VAR_SAMP(length) AS lengthsamplevariance so the displayed output matches the query.modules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-avgy.adoc (1)
58-66: ⚡ Quick winAlign output column name with alias in example
At Line 58,
AS AverageRatingis unquoted and folds to lowercase, which is why Line 66 showsaveragerating. Consider either quoting the alias or using lowercase in the query to avoid confusion.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@modules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-avgy.adoc` around lines 58 - 66, The displayed column name doesn't match the unquoted alias because SQL folds unquoted identifiers to lowercase; update the example SQL using either a quoted alias (e.g., AS "AverageRating") or change the alias to all-lowercase (e.g., AS averagerating) so the output header on the REGR_AVGY(rating, length) AS AverageRating example matches the shown result; make the change where the query uses the alias after REGR_AVGY to keep the example consistent.modules/reference/pages/sql/sql-data-types/bool.adoc (1)
88-90: ⚡ Quick winUse boolean literals instead of quoted strings in filters.
Prefer
WHERE returnedstat = TRUE/FALSEover'true'/'false'to avoid implying string comparison.Also applies to: 112-114
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@modules/reference/pages/sql/sql-data-types/bool.adoc` around lines 88 - 90, Replace string comparisons against the returnedstat column with boolean literals: change WHERE returnedstat = 'true' / 'false' to WHERE returnedstat = TRUE / FALSE in the SQL examples (e.g., the SELECT * FROM borrowbook ... WHERE returnedstat = TRUE) and update the other occurrence likewise so the examples use proper boolean comparison instead of quoted strings.modules/reference/pages/sql/sql-functions/timestamp-functions/to-char.adoc (1)
2-6: ⚡ Quick winUnify function scope and argument naming.
This page is timestamp-focused, but the description includes numeric overloads; and arguments use
formatwhile syntax usesformat_string. Align terminology to avoid ambiguity.Also applies to: 25-27
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@modules/reference/pages/sql/sql-functions/timestamp-functions/to-char.adoc` around lines 2 - 6, The page for the to_char function mixes numeric overloads and inconsistent argument names which confuses the timestamp-focused documentation; update the description to restrict scope to timestamp/date/time overloads only and change all argument references to use the canonical name format_string (e.g., in the prose and any function signatures/syntax blocks referencing to_char and its parameters) so terminology is consistent across the page (also apply the same changes to the lines referenced at 25-27).
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 741e2842-91ed-48fc-96fc-b9ba5240137d
⛔ Files ignored due to path filters (5)
modules/reference/images/sql/join-venn.pngis excluded by!**/*.pngmodules/reference/images/sql/left-join-venn.pngis excluded by!**/*.pngmodules/reference/images/sql/outer-join-venn.pngis excluded by!**/*.pngmodules/reference/images/sql/outer-join-where-venn.pngis excluded by!**/*.pngmodules/reference/images/sql/right-join-venn.pngis excluded by!**/*.png
📒 Files selected for processing (251)
modules/ROOT/nav.adocmodules/get-started/pages/whats-new-cloud.adocmodules/reference/pages/sql/comment-support.adocmodules/reference/pages/sql/index.adocmodules/reference/pages/sql/information-schema.adocmodules/reference/pages/sql/schema.adocmodules/reference/pages/sql/sql-clauses/from/from.adocmodules/reference/pages/sql/sql-clauses/from/index.adocmodules/reference/pages/sql/sql-clauses/from/join.adocmodules/reference/pages/sql/sql-clauses/from/left-join.adocmodules/reference/pages/sql/sql-clauses/from/outer-join.adocmodules/reference/pages/sql/sql-clauses/from/right-join.adocmodules/reference/pages/sql/sql-clauses/group-by.adocmodules/reference/pages/sql/sql-clauses/having.adocmodules/reference/pages/sql/sql-clauses/index.adocmodules/reference/pages/sql/sql-clauses/limit.adocmodules/reference/pages/sql/sql-clauses/offset.adocmodules/reference/pages/sql/sql-clauses/order-by.adocmodules/reference/pages/sql/sql-clauses/over-window.adocmodules/reference/pages/sql/sql-clauses/set-operations/except.adocmodules/reference/pages/sql/sql-clauses/set-operations/index.adocmodules/reference/pages/sql/sql-clauses/set-operations/intersect.adocmodules/reference/pages/sql/sql-clauses/set-operations/union.adocmodules/reference/pages/sql/sql-clauses/where.adocmodules/reference/pages/sql/sql-clauses/with.adocmodules/reference/pages/sql/sql-data-types/array.adocmodules/reference/pages/sql/sql-data-types/bool.adocmodules/reference/pages/sql/sql-data-types/bytea.adocmodules/reference/pages/sql/sql-data-types/date.adocmodules/reference/pages/sql/sql-data-types/geography.adocmodules/reference/pages/sql/sql-data-types/geometry.adocmodules/reference/pages/sql/sql-data-types/index.adocmodules/reference/pages/sql/sql-data-types/interval.adocmodules/reference/pages/sql/sql-data-types/json.adocmodules/reference/pages/sql/sql-data-types/numeric-type/numeric-data-type-aliases.adocmodules/reference/pages/sql/sql-data-types/numeric-type/numeric.adocmodules/reference/pages/sql/sql-data-types/row.adocmodules/reference/pages/sql/sql-data-types/text.adocmodules/reference/pages/sql/sql-data-types/time-type/time-operators.adocmodules/reference/pages/sql/sql-data-types/time-type/time.adocmodules/reference/pages/sql/sql-data-types/timestamp-with-time-zone.adocmodules/reference/pages/sql/sql-data-types/timestamp-without-time-zone.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/avg.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/bool-and.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/bool-or.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/count.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/distinct.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/for-max.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/for-min.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/index.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/max.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/min.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/ordered-set-aggregate-functions/index.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/ordered-set-aggregate-functions/mode.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/ordered-set-aggregate-functions/percentile-cont.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/ordered-set-aggregate-functions/percentile-disc.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/corr.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/covar-pop.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/covar-samp.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/index.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-avgx.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-avgy.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-count.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-intercept.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-r2.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-slope.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-sxx.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-sxy.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/regr-syy.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/stddev-pop.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/stddev-samp.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/stddev.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/var-pop.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/var-samp.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/statistics/variance.adocmodules/reference/pages/sql/sql-functions/aggregate-functions/sum.adocmodules/reference/pages/sql/sql-functions/boolean-functions/if-function.adocmodules/reference/pages/sql/sql-functions/boolean-functions/index.adocmodules/reference/pages/sql/sql-functions/boolean-functions/is-distinct-from-operator.adocmodules/reference/pages/sql/sql-functions/boolean-functions/is-not-distinct-from-operator.adocmodules/reference/pages/sql/sql-functions/index.adocmodules/reference/pages/sql/sql-functions/json-functions/index.adocmodules/reference/pages/sql/sql-functions/json-functions/json-array-extract.adocmodules/reference/pages/sql/sql-functions/json-functions/json-array-length.adocmodules/reference/pages/sql/sql-functions/json-functions/json-extract-path-text.adocmodules/reference/pages/sql/sql-functions/json-functions/json-extract-path.adocmodules/reference/pages/sql/sql-functions/math-functions/abs.adocmodules/reference/pages/sql/sql-functions/math-functions/cbrt.adocmodules/reference/pages/sql/sql-functions/math-functions/ceil.adocmodules/reference/pages/sql/sql-functions/math-functions/cosh.adocmodules/reference/pages/sql/sql-functions/math-functions/exp.adocmodules/reference/pages/sql/sql-functions/math-functions/floor.adocmodules/reference/pages/sql/sql-functions/math-functions/greatest.adocmodules/reference/pages/sql/sql-functions/math-functions/index.adocmodules/reference/pages/sql/sql-functions/math-functions/least.adocmodules/reference/pages/sql/sql-functions/math-functions/ln.adocmodules/reference/pages/sql/sql-functions/math-functions/log.adocmodules/reference/pages/sql/sql-functions/math-functions/power.adocmodules/reference/pages/sql/sql-functions/math-functions/random.adocmodules/reference/pages/sql/sql-functions/math-functions/round.adocmodules/reference/pages/sql/sql-functions/math-functions/sign.adocmodules/reference/pages/sql/sql-functions/math-functions/sin.adocmodules/reference/pages/sql/sql-functions/math-functions/sinh.adocmodules/reference/pages/sql/sql-functions/math-functions/sqrt.adocmodules/reference/pages/sql/sql-functions/math-functions/to-char-from-number.adocmodules/reference/pages/sql/sql-functions/other-functions/coalesce.adocmodules/reference/pages/sql/sql-functions/other-functions/col-description.adocmodules/reference/pages/sql/sql-functions/other-functions/current-database.adocmodules/reference/pages/sql/sql-functions/other-functions/current-schema.adocmodules/reference/pages/sql/sql-functions/other-functions/generate-series.adocmodules/reference/pages/sql/sql-functions/other-functions/has-schema-privilege.adocmodules/reference/pages/sql/sql-functions/other-functions/index.adocmodules/reference/pages/sql/sql-functions/other-functions/nullif.adocmodules/reference/pages/sql/sql-functions/other-functions/obj-description.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-backend-pid.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-encoding-to-char.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-get-constraintdef.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-get-expr.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-get-indexdef.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-get-statisticsobjdef-columns.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-get-userbyid.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-relation-is-publishable.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-size-pretty.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-table-is-visible.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-table-size.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-total-relation-size.adocmodules/reference/pages/sql/sql-functions/other-functions/pg-typeof.adocmodules/reference/pages/sql/sql-functions/other-functions/shobj-description.adocmodules/reference/pages/sql/sql-functions/string-functions/concat.adocmodules/reference/pages/sql/sql-functions/string-functions/ends-with.adocmodules/reference/pages/sql/sql-functions/string-functions/index.adocmodules/reference/pages/sql/sql-functions/string-functions/length.adocmodules/reference/pages/sql/sql-functions/string-functions/lower.adocmodules/reference/pages/sql/sql-functions/string-functions/position.adocmodules/reference/pages/sql/sql-functions/string-functions/regex/index.adocmodules/reference/pages/sql/sql-functions/string-functions/regex/posix-regular-expressions.adocmodules/reference/pages/sql/sql-functions/string-functions/regex/regexp-match.adocmodules/reference/pages/sql/sql-functions/string-functions/regex/regexp-replace.adocmodules/reference/pages/sql/sql-functions/string-functions/replace.adocmodules/reference/pages/sql/sql-functions/string-functions/starts-with.adocmodules/reference/pages/sql/sql-functions/string-functions/strpos.adocmodules/reference/pages/sql/sql-functions/string-functions/substring.adocmodules/reference/pages/sql/sql-functions/string-functions/upper.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/current-timestamp.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/date-trunc.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/extract.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/format-timestamp.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/index.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/timestamp-micros.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/timestamp-millis.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/timestamp-seconds.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/timestamp-trunc.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/to-char.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/to-timestamp.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/unix-micros.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/unix-millis.adocmodules/reference/pages/sql/sql-functions/timestamp-functions/unix-seconds.adocmodules/reference/pages/sql/sql-functions/window-functions/avg.adocmodules/reference/pages/sql/sql-functions/window-functions/bool-and.adocmodules/reference/pages/sql/sql-functions/window-functions/bool-or.adocmodules/reference/pages/sql/sql-functions/window-functions/count.adocmodules/reference/pages/sql/sql-functions/window-functions/cume-dist.adocmodules/reference/pages/sql/sql-functions/window-functions/dense-rank.adocmodules/reference/pages/sql/sql-functions/window-functions/first-value.adocmodules/reference/pages/sql/sql-functions/window-functions/index.adocmodules/reference/pages/sql/sql-functions/window-functions/lag.adocmodules/reference/pages/sql/sql-functions/window-functions/last-value.adocmodules/reference/pages/sql/sql-functions/window-functions/lead.adocmodules/reference/pages/sql/sql-functions/window-functions/max.adocmodules/reference/pages/sql/sql-functions/window-functions/min.adocmodules/reference/pages/sql/sql-functions/window-functions/nth-value.adocmodules/reference/pages/sql/sql-functions/window-functions/ntile.adocmodules/reference/pages/sql/sql-functions/window-functions/percent-rank.adocmodules/reference/pages/sql/sql-functions/window-functions/rank.adocmodules/reference/pages/sql/sql-functions/window-functions/row-number.adocmodules/reference/pages/sql/sql-functions/window-functions/sum.adocmodules/reference/pages/sql/sql-operators/bitwise-shift-left.adocmodules/reference/pages/sql/sql-operators/bitwise-shift-right.adocmodules/reference/pages/sql/sql-operators/index.adocmodules/reference/pages/sql/sql-statements/alter-iceberg-catalog.adocmodules/reference/pages/sql/sql-statements/alter-redpanda-catalog.adocmodules/reference/pages/sql/sql-statements/alter-storage.adocmodules/reference/pages/sql/sql-statements/alter-table.adocmodules/reference/pages/sql/sql-statements/alter-user.adocmodules/reference/pages/sql/sql-statements/copy-to.adocmodules/reference/pages/sql/sql-statements/create-iceberg-catalog.adocmodules/reference/pages/sql/sql-statements/create-redpanda-catalog.adocmodules/reference/pages/sql/sql-statements/create-storage.adocmodules/reference/pages/sql/sql-statements/create-table.adocmodules/reference/pages/sql/sql-statements/create-user.adocmodules/reference/pages/sql/sql-statements/describe.adocmodules/reference/pages/sql/sql-statements/drop-iceberg-catalog.adocmodules/reference/pages/sql/sql-statements/drop-redpanda-catalog.adocmodules/reference/pages/sql/sql-statements/drop-storage.adocmodules/reference/pages/sql/sql-statements/drop-table.adocmodules/reference/pages/sql/sql-statements/drop-user.adocmodules/reference/pages/sql/sql-statements/grant.adocmodules/reference/pages/sql/sql-statements/index.adocmodules/reference/pages/sql/sql-statements/keywords.adocmodules/reference/pages/sql/sql-statements/revoke.adocmodules/reference/pages/sql/sql-statements/select.adocmodules/reference/pages/sql/sql-statements/set-show.adocmodules/reference/pages/sql/sql-statements/show-catalogs.adocmodules/reference/pages/sql/sql-statements/show-execs.adocmodules/reference/pages/sql/sql-statements/show-nodes.adocmodules/reference/pages/sql/sql-statements/show-queries.adocmodules/reference/pages/sql/sql-statements/show-tables.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_attrdef.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_attribute.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_authid.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_class.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_constraint.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_database.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_depend.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_description.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_index.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_language.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_namespace.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_proc.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_roles.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_settings.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_shadow.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_statio_user_tables.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_type.adocmodules/reference/pages/sql/system-catalogs/catalogs/pg_user.adocmodules/reference/pages/sql/system-catalogs/index.adocmodules/reference/pages/sql/system-virtual-tables.adocmodules/reference/pages/sql/transactions.adocmodules/sql/pages/connect-to-sql/authenticate.adocmodules/sql/pages/connect-to-sql/index.adocmodules/sql/pages/connect-to-sql/language-clients/dotnet-dapper.adocmodules/sql/pages/connect-to-sql/language-clients/java-jdbc.adocmodules/sql/pages/connect-to-sql/language-clients/php-pdo.adocmodules/sql/pages/connect-to-sql/language-clients/psycopg2.adocmodules/sql/pages/get-started/deploy-sql-cluster.adocmodules/sql/pages/get-started/index.adocmodules/sql/pages/get-started/oltp-vs-olap.adocmodules/sql/pages/get-started/overview.adocmodules/sql/pages/get-started/redpanda-sql-vs-postgresql.adocmodules/sql/pages/get-started/sql-quickstart.adocmodules/sql/pages/index.adocmodules/sql/pages/manage/index.adocmodules/sql/pages/manage/manage-access.adocmodules/sql/pages/query-data/index.adocmodules/sql/pages/query-data/query-iceberg-topics.adocmodules/sql/pages/query-data/query-nested-fields.adocmodules/sql/pages/query-data/query-streaming-topics.adocmodules/sql/pages/query-data/redpanda-catalogs.adocmodules/sql/pages/troubleshoot/degraded-state-handling.adocmodules/sql/pages/troubleshoot/index.adocmodules/sql/pages/troubleshoot/query-out-of-memory.adoc
| Special case: | ||
|
|
||
| * Returns `NULL` for the `NULL` record. | ||
| * Returns `true` (including the `NULL` record) if the `second_argument` is not specified. |
Contributor
There was a problem hiding this comment.
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
set -euo pipefail
# Locate and print the relevant doc section with line numbers
file="modules/reference/pages/sql/sql-functions/string-functions/starts-with.adoc"
echo "=== $file (lines 1-250) ==="
if [ -f "$file" ]; then
nl -ba "$file" | sed -n '1,250p'
else
echo "File not found: $file" >&2
fi
# Search for occurrences of the key phrases across the file
echo
echo "=== grep: second_argument / not specified / NULL / '' / empty string ==="
rg -n "second_argument|not specified|NULL|''|empty string|omitted" "$file" || trueRepository: redpanda-data/cloud-docs
Length of output: 227
🏁 Script executed:
#!/bin/bash
set -euo pipefail
file="modules/reference/pages/sql/sql-functions/string-functions/starts-with.adoc"
echo "=== $file (first 260 lines) ==="
if [ -f "$file" ]; then
awk '{printf "%d\t%s\n", NR, $0}' "$file" | sed -n '1,260p'
else
echo "File not found: $file" >&2
exit 1
fi
echo
echo "=== occurrences ==="
rg -n "second_argument|not specified|NULL|''|empty string|omitted" "$file" || trueRepository: redpanda-data/cloud-docs
Length of output: 6163
Fix starts_with docs: “second_argument not specified” + NULL example mismatch
- The special case claims
starts_withreturnstrue(including theNULLrecord) whensecond_argumentis not specified, but the example explicitly callsSTARTS_WITH(breed, '')(so omitted-argument behavior isn’t shown). - The example says
breedcontains aNULLvalue, but the INSERT uses an empty string (''), and the results table labels that row asnull, which conflicts with the shown SQL.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@modules/reference/pages/sql/sql-functions/string-functions/starts-with.adoc`
at line 20, The docs for starts_with are inconsistent: either demonstrate the
omitted-argument behavior or correct the text to describe the empty-string case,
and make the example data/result consistent about NULL vs empty string. Update
the sentence about second_argument to match the example (e.g., "Returns true if
second_argument is an empty string (or when omitted show omitted-argument
behavior)"), or change the example SQL to call STARTS_WITH(breed) with the
argument omitted; then fix the INSERT to use NULL (INSERT ... VALUES (NULL)) if
you want a NULL row, and make the results table show NULL (not the empty string)
so INSERT, the STARTS_WITH call, and the results table are all consistent;
reference starts_with / STARTS_WITH(breed, '') / INSERT and the results table
when making edits.
micheleRP
reviewed
May 23, 2026
Comment on lines
+6
to
+13
| * xref:reference:sql/sql-statements/index.adoc[SQL Statements]: Learn how to create a request for data or information from one or more database tables using supported statements. | ||
| * xref:reference:sql/sql-clauses/index.adoc[SQL Clauses]: Learn how to write user-friendly queries and analyze data using different constraints and conditions. | ||
| * xref:reference:sql/sql-data-types/index.adoc[SQL Data Types]: Learn how to implement supported data types to run your operations, such as text, timestamp, numeric, and many more. | ||
| * xref:reference:sql/sql-functions/index.adoc[SQL Functions]: See how you can combine statements, data types, and other references into specific functions for particular tasks. | ||
| * xref:reference:sql/information-schema.adoc[Information Schema]: Inspect database object metadata and privilege grants through SQL-standard `information_schema` views. | ||
| * xref:reference:sql/schema.adoc[Schema]: Learn about a logical container that holds database objects and relationships of data in a database. | ||
| * xref:reference:sql/comment-support.adoc[Comment Support]: Add comments in your queries for better documentation and collaboration. | ||
| * xref:reference:sql/transactions.adoc[Transactions]: Learn more about managing your transactions. |
Contributor
There was a problem hiding this comment.
Suggested change
| * xref:reference:sql/sql-statements/index.adoc[SQL Statements]: Learn how to create a request for data or information from one or more database tables using supported statements. | |
| * xref:reference:sql/sql-clauses/index.adoc[SQL Clauses]: Learn how to write user-friendly queries and analyze data using different constraints and conditions. | |
| * xref:reference:sql/sql-data-types/index.adoc[SQL Data Types]: Learn how to implement supported data types to run your operations, such as text, timestamp, numeric, and many more. | |
| * xref:reference:sql/sql-functions/index.adoc[SQL Functions]: See how you can combine statements, data types, and other references into specific functions for particular tasks. | |
| * xref:reference:sql/information-schema.adoc[Information Schema]: Inspect database object metadata and privilege grants through SQL-standard `information_schema` views. | |
| * xref:reference:sql/schema.adoc[Schema]: Learn about a logical container that holds database objects and relationships of data in a database. | |
| * xref:reference:sql/comment-support.adoc[Comment Support]: Add comments in your queries for better documentation and collaboration. | |
| * xref:reference:sql/transactions.adoc[Transactions]: Learn more about managing your transactions. | |
| * xref:reference:sql/sql-statements/index.adoc[SQL Statements] | |
| + | |
| Learn how to create a request for data or information from one or more database tables using supported statements. | |
| * xref:reference:sql/sql-clauses/index.adoc[SQL Clauses] | |
| + | |
| Learn how to write user-friendly queries and analyze data using different constraints and conditions. | |
| * xref:reference:sql/sql-data-types/index.adoc[SQL Data Types] | |
| + | |
| Learn how to implement supported data types to run your operations, such as text, timestamp, numeric, and many more. | |
| * xref:reference:sql/sql-functions/index.adoc[SQL Functions] | |
| + | |
| See how you can combine statements, data types, and other references into specific functions for particular tasks. | |
| * xref:reference:sql/information-schema.adoc[Information Schema] | |
| + | |
| Inspect database object metadata and privilege grants through SQL-standard `information_schema` views. | |
| * xref:reference:sql/schema.adoc[Schema] | |
| + | |
| Learn about a logical container that holds database objects and relationships of data in a database. | |
| * xref:reference:sql/comment-support.adoc[Comment Support] | |
| + | |
| Add comments in your queries for better documentation and collaboration. | |
| * xref:reference:sql/transactions.adoc[Transactions] | |
| + | |
| Learn more about managing your transactions. |
@kbatuigas suggest formatting this like our standard index pages. But also: this list is not complete and does not follow order listed in nav.
micheleRP
reviewed
May 23, 2026
micheleRP
reviewed
May 23, 2026
Contributor
|
Suggestion from Claude about the order of the Redpanda SQL Reference section in The current top-level order (Keywords → Statements → Clauses → Data Types → Functions → Operators → System Catalogs) follows a logical "build up the language" progression and mirrors how Postgres and most SQL references are organized. The five items at the end feel like a loose tail, and most don't really belong together:
Suggested reordering
Resulting top-level order under Redpanda SQL Reference:
|
Contributor
|
Link audit from Claude on the new SQL files (226 .adoc files added under
All internal links within the new SQL content resolve. Every One xref worth a quick eyeball: Any current build errors are coming from outside the SQL content. |
Co-authored-by: Michele Cyran <michele@redpanda.com>
- sql/index.adoc: rewrite with AsciiDoc list-continuation format and align order/contents with nav.adoc, adding Operators, System Catalogs, System Virtual Tables, and Transactions entries (per micheleRP). - starts-with.adoc: reconcile the prose, INSERT, and results table for the empty-string-second-argument case. The example uses '' (not an omitted argument or NULL), so update the special-case bullet, section heading, intro, and results-table empty-string row to match (per coderabbitai). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* Update Cloud docs landing page to component-home-v3 Migrates Cloud docs landing page to use the new component-home-v3 layout with configurable content via page attributes. ## Deploy Section - :page-deploy-title: Section heading - :page-deploy-N-title/desc/link/icon: Card content (up to 3) ## Popular Topics Section - :page-popular-title: Section heading - :page-popular-N-title/desc/link/icon: Card content (up to 4) ## Labs Section - :page-labs-title: Section heading - :page-labs-link: Link to all labs - :page-labs-N-title/link: Individual lab links ## Stats Bar - :page-stats: Pipe-separated stats with ;; delimiter Related: redpanda-data/docs-ui#376 * Update component xrefs for unified navigation - Updated xrefs and includes: ROOT → streaming - Updated xrefs: redpanda-connect → connect This allows cloud-docs to correctly include single-sourced content from the renamed streaming component. * Rename Redpanda Self-Managed to Redpanda Streaming Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Fix cloud landing page hero - add missing page-layout and hero-description Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Add product-name attribute for single-sourced content Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Update product-name attributes with clear naming - product-name: Redpanda Streaming (for self-managed references) - cloud-product-name: Redpanda Cloud (for cloud references) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Remove local product-name attributes (now in shared branch) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Rename page-header-data to component-metadata and remove section field - More accurate name: component-level metadata, not page-level - Remove section field (deprecated - breadcrumbs use page-navigation config) - Update Cloud component configuration Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Update Cloud landing page: hero text, remove deploy section, update labs - Hero: Add "Streaming, Connect, and SQL built in" to clarify offerings - Remove "Get started with Redpanda Cloud" deploy section per PM feedback - Update labs links to use Antora resource IDs (labs:ai-agents:langchain-agent.adoc, etc.) - All labs are Cloud-compatible (have page-cloud: true attribute) - Decision matrix remains for Serverless vs BYOC choice Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Fix mcp-setup xref to use correct module Change xref:home:streaming:mcp-setup.adoc to xref:home:ROOT:mcp-setup.adoc Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Migrate SQL docs (#521) * Add converted SQL reference files * Duplicate file * Add index files * Add SQL reference to Cloud nav * Move reference pages to reference module * Convert remaining docs * Add placeholder index files * Cleanup * Move SQL section after RPCN * Continue cleanup using plugin audit and review * External links open in new window * Minor edit to trigger deploy preview * Migrate degraded state doc * Minor style edits * Address drift from Oxla changes since mid-Oct 2025 * Include CREATE TABLE and DROP changes * Update existing pages with placeholders for pages to be created * Another pass at style fixes * Missing TODO * Add remaining new reference pages to address doc drift * Remove Oxla storage compression references * Remove INSERT/UPDATE/DELETE from psycopg2 supported features * Remove Oxla-specific reasons from java-jdbc unsupported list * Remove DELETE/UPDATE references from php-pdo rowCount * Remove CREATE TABLE/INSERT example from select.adoc Assume that a student_data table is already created and populated with data * Remove table duplication TIP * Fix clumped "SELECTstatement" * Add missing Venn diagrams to JOIN pages * Inconsistent formatting with function names and parentheses * Incorrect COUNT logic with HAVING * Add NULLS FIRST/LAST, fix interval sorting * Replace CREATE TABLE oxlafunctions example in offset.adoc Redpanda SQL does not support CREATE TABLE without an external catalog Example assumes precreated salaryemp table * Unrelated "employees" text * Move column compatibility note to set-operations index Column type compatibility and flexible ordering applies to all set operations (UNION, INTERSECT, EXCEPT) * Both ROWS and RANGE frame modes are supported * Add GEOMETRY/GEOGRAPHY * Create sql-operators section with full operator list * timestamp-with-time-zone formatting * Remove internal memory representation for date type * Add month and day conversion note * Remove internal memory representation from bool type * System catalogs disambiguation note and 7 new pg_* pages * Fix nav * Move bitwise operators * Double check SQL examples and outputs * Remove unix_macros * Reorganize math and trig function pages * Implement some deferred fixes related to old Oxla examples * Fix anchors in xrefs * Apply QA checklist first pass across SQL reference docs Run 11-point QA checklist against all migrated SQL pages (148 files). Fixes applied: remove "Please note" phrasing, fix "here" link text, replace future tense output descriptions with present tense, simplify "allows/enables you to" constructions, remove minimizing language, fix wordy instructions, add missing admonition punctuation, replace verbose output lead-ins, remove "etc.", normalize positional references, and update stale PostgreSQL doc links to /docs/current/. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Person 4 edits, including future tense, passive voice * more Person 4 edits * Person 4 edits * Parallelize :description: metadata for SQL language client pages Standardize the Java, PHP, and Python connector pages on the same imperative "Connect to Redpanda SQL from <language> using <tool>" template already used by the C# page and the parent index page. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Apply Feediver1 review suggestions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Apply pending PR suggestion comments Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Minor edit - statements index * keywords.adoc - move in nav tree, make table more scannable * alter-table minor edit * create-redpanda-catalog: Improve Options section * create-storage minor edit * Improve CREATE TABLE reference page clarity Clarify NOTE about CREATE TABLE behavior, convert multi-value option descriptions to lists for scannability, and rename ambiguous example heading. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * select: review fixes * set-show: review fixes * show-tables minor edit * show-nodes: review fixes * describe: review fixes * sql-statements review pass * from - review pass * Minor edit * set-operations: review fixes * More review fixes for sql-clauses * other-functions review fixes * Normalize QA fixes * Apply edits based on doc team review * Standardize "To do X, run:" * Structural improvements * Sweep for passive voice * Person 2 style review: aggregate, window, JSON functions Style fixes across 31 files: - Future tense → present tense ("will return" → "returns") - Wordy instructions ("lets you" → direct verb) - Awkward phrasing ("Here's how" → cleaner alternatives) - First person ("we're going to" → "This example") - Passive "It" patterns in tables → active voice - Positional references ("the above query" → "Output:") - Typo fix ("ouput" → "output") Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Pass to standardize QA * Apply suggestions from review * Minor edits --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: micheleRP <michele@redpanda.com> Co-authored-by: Joyce Fee <joyce@redpanda.com> Co-authored-by: JakeSCahill <jake@redpanda.com> * SQL GA nav (#572) * SQL GA nav * DOC-1993: Move Redpanda Catalogs page to sql module under Query data Relocates redpanda-catalogs.adoc from modules/reference/pages/sql/ to modules/sql/pages/query-data/, adds the entry under SQL > Query data in nav.adoc, removes the old entry from Reference > Redpanda SQL Reference, and updates the cross-link in system-catalogs/index.adoc. Structural-only; no content changes (content rewrite is in DOC-2049). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Add component-whats-new attributes for SQL feature * Fix SQL What's New link to use full component prefix * Add page-level What's New attributes for cloud home page - Duplicate component-whats-new attributes as page-whats-new - page-whats-new displays on cloud home page - component-whats-new displays on data-platform aggregation page - Both point to same SQL content * Remove duplicate page-role attribute from cloud home page Only page-layout is needed; page-role is redundant as the layout automatically sets the correct role class. * Add component-specific AI suggestions for chat drawer Defines 4 cloud-specific AI suggestion questions that appear in the Ask AI chat drawer when viewing Cloud documentation. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Restructure cloud landing page and fix SQL nav xrefs - Add component cards section (Streaming, Connect, SQL) with NEW and BYOC badges - Add deployment cards section (Serverless, BYOC, Dedicated) - Remove What's New, Features, Labs, and Path comparison sections - Comment out SQL nav items for pages that don't exist yet - Keep only existing SQL pages active in navigation Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Fix component name from ROOT to streaming in includes * Fix broken includes: salesforce inputs path and cloud-topics placeholder * Add stub pages for salesforce_cdc and salesforce_graphql inputs * Add page-aliases to salesforce stub pages for xref resolution * Enable parent context navigation cards Add page-use-parent-context flag to enable hierarchical navigation with parent context cards in the UI. This shows the Data Platform umbrella in the product selector and the Cloud card in navigation. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Remove unused page-use-parent-context flag * Update component color to match design system Changed from #0ea5e9 to #1D4ED8 (Cloud blue from color wheel). Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Fix home page review feedback - Replace em dashes with commas in descriptions - Change lock icon to book (supported v3 icon) - Use active voice in component and popular descriptions - Soften marketing claims (10x faster → high-performance, 99.99% SLA → enterprise SLA) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Fix unescaped attributes in AsciiDoc files Escape curly braces to prevent AsciiDoc from interpreting them as attribute references: - concepts.adoc: {server-id} - disable-kc.adoc: {id}, {operation.id} - whats-new-cloud.adoc: {subject} Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Add Salesforce connector pages to navigation Added salesforce_cdc and salesforce_graphql input pages to the navigation in alphabetical order. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * Remove conflicting page-alias from overview.adoc The alias pointed to what-is-redpanda-sql.adoc which exists as a separate file, causing Antora build failure. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Revert "Remove conflicting page-alias from overview.adoc" This reverts commit e20dd61. * Remove conflicting page-alias from SQL overview The alias pointed to what-is-redpanda-sql.adoc which exists as a separate file, causing Antora build failure. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Remove conflicting page-alias from substring.adoc The alias pointed to substr.adoc which exists as a separate file. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Remove unlisted SQL pages not in rp-sql branch These files were introduced during rebase but don't exist in the authoritative rp-sql branch: - substr.adoc (duplicate of substring.adoc) - what-is-redpanda-sql.adoc (replaced by overview.adoc) - numeric-type/index.adoc - time-type/index.adoc Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> Co-authored-by: Kat Batuigas <36839689+kbatuigas@users.noreply.github.com> Co-authored-by: micheleRP <michele@redpanda.com> Co-authored-by: Joyce Fee <joyce@redpanda.com>
JakeSCahill
approved these changes
May 26, 2026
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
3 participants
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.
Add migrated Oxla docs
New SQL docs for GA (will be continuously merged into rp-sql branch leading up to GA release)
Page previews
https://deploy-preview-570--rp-cloud.netlify.app/redpanda-cloud/sql/
https://deploy-preview-570--rp-cloud.netlify.app/redpanda-cloud/reference/sql/