jackylee-ch opened a new pull request, #669: URL: https://github.com/apache/paimon-rust/pull/669
`$files` and `$branches` are registered system tables — `SYSTEM_TABLE_NAMES` lists both, and the 0.3.0 release notes already advertise `$files` — but the SQL reference documented only 9 of the 11, so users had no way to learn the column names without reading `system_tables/files.rs`. `$files` is the most useful of the set for debugging compaction and skew, which makes the omission the more visible one. **Fix**: add a `### $files` and a `### $branches` section to `docs/src/sql.md`, following the existing `$tags`/`$table_indexes` shape (purpose sentence, sample query, column table). Column names and order are taken verbatim from `files_schema()` (20 columns) and `branches_schema()` (2 columns); Arrow types are rendered in the SQL spelling the surrounding sections already use. The `$branches` section also notes the one behavior that sets it apart from its neighbours: it ignores a `$branch_<name>` prefix and always reports the base table's branches. Docs only — no code or test changes. -- 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]
