Skip to content

[docs] Fix full-text index option defaults and search query examples - #9062

Merged
JingsongLi merged 1 commit into
apache:masterfrom
thswlsqls:docs/fix-full-text-index-docs
Aug 7, 2026
Merged

[docs] Fix full-text index option defaults and search query examples#9062
JingsongLi merged 1 commit into
apache:masterfrom
thswlsqls:docs/fix-full-text-index-docs

Conversation

@thswlsqls

Copy link
Copy Markdown
Contributor

Purpose

fix #9061

  • Copying the primary-key full-text examples fails with invalid query: full-text query column 'content' is not configured for this index. The column is a procedure/API argument, not a JSON field (full-text.mdx Notes). From [spark][flink][docs] Expose primary-key full-text search #8659; corrected in 5 places.
  • docs/primary-key-table/global-index delegates analyzer options to this README, whose Default column still holds pre-full-text Tantivy values: stem/remove-stop-words/ascii-folding say false, 0.1.0 defaults them true; ngram.min-gram/max-gram say 2 but default to 3 — a two-character ngram query from this table returns zero rows. Adds missing jieba rows.

Tests

  • Docs only — no test added.
  • Defaults checked against paimon-full-text-index 0.1.0, comparing search hits of default vs. explicit-option indexes (macOS aarch64 / JDK 11): min/max-gram, ascii-folding, stem, remove-stop-words, the stop-words constraint and jieba.search-mode. jieba.ordinal-position mirrors full-text.mdx.
  • Query examples replayed against the native reader: the documented one throws, the corrected returns rows.

The primary-key full-text search examples pass the column inside the query
JSON, which the native reader rejects with "invalid query: full-text query
column 'content' is not configured for this index". The Paimon column is
supplied as the procedure/API argument instead.

The paimon-full-text README analyzer table, which the primary-key global
index docs delegate to, still carries the pre-full-text defaults: stem,
remove-stop-words and ascii-folding are true, and ngram.min-gram/max-gram
default to 3.

Generated-by: Claude Code
@JingsongLi

Copy link
Copy Markdown
Contributor

+1

@JingsongLi
JingsongLi merged commit 2e4b9cd into apache:master Aug 7, 2026
3 checks passed
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.

[Bug] Documented primary-key full-text search examples fail with invalid query

2 participants