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: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
