Skip to content

[doc](variant) Describe the new meaning of count 0 and VARIANT columns in changelog - #4578

Open
csun5285 wants to merge 9 commits into
apache:masterfrom
csun5285:variant-serialize-type
Open

csun5285 wants to merge 9 commits into
apache:masterfrom
csun5285:variant-serialize-type

Conversation

@csun5285

@csun5285 csun5285 commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Versions

  • dev
  • 4.x
  • 3.x
  • 2.1 or older (not covered by version/language sync gate)

Languages

  • Chinese
  • English

Docs Checklist

  • Checked by AI
  • Test Cases Built
  • Updated required version and language counterparts, or explained why not
  • If only one language changed, confirmed whether source/translation counterparts need sync

csun5285 and others added 4 commits October 30, 2026 09:05
… changelog

Documents apache/doris#69812 for the dev docs, in English and Chinese:

- VARIANT: the new column property variant_serialize_type, what
  variant_max_subcolumns_count = 0 means under v1 and v2, how it relates
  to subpath indexes, and that DESC and SHOW CREATE TABLE state it.
- SEARCH: the VARIANT example needs subcolumn indexes, so it states v1.
- Changelog: VARIANT columns are supported with v2 and no nested group,
  how their images are stored and how they are read.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ize type

variant_serialize_type is an internal field, so the docs no longer mention it.
variant_max_subcolumns_count = 0 now means that no dynamic path gets a subcolumn. A column created
before version 4.2 keeps materializing every dynamic path, and only that column does: a table
created from it through SHOW CREATE TABLE output, CREATE TABLE LIKE or CTAS gets the new meaning.
The SEARCH example needs subcolumns, so it states a count of 2048.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The 4.x docs cover versions before and after the change, so they state that
variant_max_subcolumns_count = 0 keeps dynamic paths in sparse columns from version 4.2, and that
a column created earlier keeps no limit. The SEARCH example needs subcolumns, so it states a count
of 2048. There is no changelog page in 4.x.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… section

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
csun5285 and others added 5 commits November 2, 2026 01:43
…t-0 column

The new table shows the same definition but stores every dynamic path in sparse columns. State what
that changes for reads, SEARCH, score() and MATCH, and how to keep the subcolumns.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ount 0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… 4.2

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… a VARIANT changelog read

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

1 participant