Skip to content

[docs] Expand CREATE TABLE property reference for Dev and 4.x - #4633

Open
morningman wants to merge 1 commit into
apache:masterfrom
morningman:docs/issue-1301-create-table-properties-20261112
Open

morningman wants to merge 1 commit into
apache:masterfrom
morningman:docs/issue-1301-create-table-properties-20261112

Conversation

@morningman

Copy link
Copy Markdown
Contributor

The CREATE TABLE reference omits table properties that users otherwise have to discover in feature pages or source. Add a type/default/constraints reference for 30 properties in Dev and 25 in 4.x, in both English and Chinese. It covers prefix/Bloom indexes, row and column pages, storage policies and vaults, cache protection, bucketing, retention, compaction, Group Commit, and CCR.

The version audit includes master, branch-4.1, branch-4.2, and 4.2.0-rc03. SNII and partition.inverted_index_storage_format are available since 4.2.0 and appear in both documentation versions. Sequence mapping and row-level TTL remain Dev-only; TTL retains its 5.0.0 experimental marker. The reference distinguishes ordinary table properties from index, VARIANT-column, and materialized-view properties, and directs auto_analyze_policy users to ALTER TABLE. Six existing Chinese parameter links are also repaired.

Source verification: master PropertyAnalyzer, 4.1 create path, 4.2 PropertyAnalyzer, and corresponding CreateTableInfo, CloudPropertyAnalyzer, BinlogConfig, and storage/load consumers. Rejected or internal constants were not inferred to be user-facing options.

Validation: scoped link lint reports zero findings; all four Markdown/GFM pages compile; property-key sets match between locales and exist in the corresponding source snapshots; git diff --check passes. i18n sync reports only two informational 3.x candidates; the requested scope is Dev and 4.x. No full site build or SQL runtime tests were run.

Fixes #1301

@morningman morningman mentioned this pull request Nov 12, 2026

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.

Issue on docs

1 participant