Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Docs: SQL CREATE INDEX ... USING fts WITH (...) options are undocumented (only with_position appears)

Aperta
  • Qualcosa non va?
#370 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
78/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
python, sql
Ambito
databases, documentation, search

Direzione di ricerca

Start with docs/search/sql/fts-sql.mdx and compare its existing WITH example with the accepted key list in the issue. Check the referenced engine.rs:4832-4857 behavior for code-only flags, then document every key with types and defaults and add a code-search example with a wait-for-index step.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

documentation

Bug bash: Ready to fix

Bug bash priority: Low · critical-fix: no
From the FTS for Code bug bash (2026-10-01), findings: sdkdocs-8.md. Repros ran against released artifacts (pylance 12.0.0 / 13.0.0b18, lancedb 0.39.0 / 0.40.0b12, @lancedb/lancedb 0.40.0-beta.12) unless stated. $S is the bug bash scratch dir.

Docs gap, not dispatched.

  • Category: docs gap
  • Environment: lancedb/docs main at 7fa2ff6; LanceDB Enterprise lancedb server + Flight SQL CLI, Linux arm64
  • Artifacts: CLI release-2026-10-01.148d419ac8.verified
  • Target tracker: GitHub lancedb/docs (and Linear Enterprise for LanceDB Enterprise-side reference)

Repro

docs/search/sql/fts-sql.mdx:71-81 (the only SQL FTS index docs):

run_query("CREATE INDEX ON my_docs USING fts (text)")
...
CREATE INDEX ON my_docs USING fts (text) WITH (with_position = true)

No other WITH key is documented anywhere on the docs site (grep -rn -i "using fts" docs returns only these lines and :192).

The server does accept the code flags, and that is the only way for a LanceDB user to get identifier splitting today (PW-1):

$ lancedb ... -c "CREATE INDEX code_idx ON code_t USING fts (code) WITH (base_tokenizer = 'code', split_identifiers = true, with_position = true)"
CREATE INDEX
# list_indices() from lancedb Python remote:
index_details={'base_tokenizer': 'code', 'with_position': True, 'stem': False, 'remove_stop_words': False,
 'split_identifiers': True, 'split_on_numerics': True, 'preserve_original': True, 'index_operators': False, 'block_size': 128, 'document_granularity': 'row', ...}

Expected behavior

fts-sql.mdx (or a SQL reference page) lists every WITH key for USING fts, with types and defaults. It should flag the code-only flags (rejected unless base_tokenizer = 'code', engine.rs:4832-4857) and include a code-search example.

Evidence: accepted key list above.

Suspected root cause

The SQL FTS page was written before the code flags were added to build_fts_params and never got an options table.

Fix direction

Add an options table to docs/search/sql/fts-sql.mdx, generated from or checked against build_fts_params, plus a code example with a wait-for-index step.

Lingua principale
Python
Stelle
11
Fork
13
Merge medio
1g 12h
PR unite (30g)
9

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di lancedb/docs

Tutte le issue di lancedb/docs

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.