You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@doris.apache.org by "u70b3 (via GitHub)" <gi...@apache.org> on 2026/10/15 03:29:23 UTC
[PR] [doc](lance) add doc about lance_index_entries TVF [doris-website]
u70b3 opened a new pull request, #4311:
URL: https://github.com/apache/doris-website/pull/4311
Document the physical `lance_index_entries` table-valued function for Lance Filesystem Catalog tables added in apache/doris#66671. This closes the documentation item deferred in that PR and tracked in apache/doris#66497 ("Show index names, UUIDs, columns, types, and dataset versions ... user documentation for the physical `lance_index_entries` TVF remains outstanding"). It also resolves the forward reference to `lance_index_entries()` already present in the Lance time-travel limitations (#4172).
## What Changed
- `lakehouse/catalogs/lance-catalog.mdx` (EN + zh-CN)
- Feature Overview: metadata access now lists the `lance_index_entries` TVF alongside `SHOW INDEX` (both Filesystem Catalogs only); the system-tables row points users to both surfaces for index metadata.
- New "List Physical Index Entries with lance_index_entries" subsection under "Inspect Lance Indexes": why the physical view exists (UUID and dataset version do not fit the fixed MySQL-style 13-column `SHOW INDEX` schema), the six fixed columns, the dataset-version semantics recorded on each entry, read/validation semantics (all-or-error, 16,384 raw-entry cap, reserved system indexes validated but not displayed, ordered by `(IndexName, IndexUuid)`), ordinary-predicate filtering, the `SHOW` privilege requirement, and the fixed `lance_index_entries is not supported for Lance REST catalogs` error.
- `sql-manual/sql-functions/table-valued-functions/lance-index-entries.md` (EN + zh-CN, new)
- Standalone TVF reference: description, syntax, required `table` parameter (fully qualified three-part name, backtick quoting), the fixed return columns, and examples including a predicate filter. Linked back to the Lance Catalog page.
- `versioned_sidebars/version-4.x-sidebars.json`
- Registered the new page in the table-valued-functions list (alphabetical, between `jobs` and `local`).
`docs/` (dev) is intentionally untouched: the Lance catalog documentation is not present in dev because apache/doris master has no Lance code (the feature lives on branch-4.1), matching #4090.
## Version Note for Reviewers
The code shipped on the 4.1 line: apache/doris#66671 merged into `branch-4.1` on 2026-09-06 and is first contained in `4.1.5-rc01` (`4.1.4-rc04` does not contain it). As in #4090, the new content adds no version marker of its own and inherits the page-level note "Lance Catalog is supported starting from Apache Doris 4.2"; please confirm whether that page note should be corrected.
## Versions
- [ ] dev
- [x] 4.x
- [ ] 3.x
- [ ] 2.1 or older (not covered by version/language sync gate)
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [x] Checked by AI
- [ ] Test Cases Built
- [x] Updated required version and language counterparts, or explained why not
- [ ] If only one language changed, confirmed whether source/translation counterparts need sync
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org
Re: [PR] [doc](lance) add doc about lance_index_entries TVF [doris-website]
Posted by "morningman (via GitHub)" <gi...@apache.org>.
morningman merged PR #4311:
URL: https://github.com/apache/doris-website/pull/4311
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org