Skip to content

[doc](catalog) Add read capabilities to catalog matrices - #4124

Open
OIiveirra wants to merge 2 commits into
apache:masterfrom
OIiveirra:codex/doris-28228-catalog-read-capabilities
Open

[doc](catalog) Add read capabilities to catalog matrices#4124
OIiveirra wants to merge 2 commits into
apache:masterfrom
OIiveirra:codex/doris-28228-catalog-read-capabilities

Conversation

@OIiveirra

Copy link
Copy Markdown
Contributor

Versions

  • dev
  • 4.x
  • 3.x
  • 2.1 or older (not covered by version/language sync gate)

Languages

  • Chinese
  • English

Docs Checklist

  • Checked by AI
  • Test Cases Built
  • Updated required version and language counterparts, or explained why not
  • If only one language changed, confirmed whether source/translation counterparts need sync

Summary

  • add explicit view read capabilities to the Iceberg and Paimon matrices
  • add branch and tag read capabilities based on table@branch(...) and table@tag(...) queries
  • add Iceberg metadata table read capability
  • keep the English and Chinese matrices synchronized

This is a follow-up to #4116 and updates the current/dev documentation only.

Validation

  • git diff --check origin/master
  • verified every table row has the expected number of cells
  • verified each rowSpan matches its capability group
  • verified English and Chinese operation ordering and support statuses are identical

Copilot AI lite review requested due to automatic review settings September 8, 2026 08:04

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The zh-CN Iceberg matrix introduces a new “Metadata Table” group label that remains in English and should be localized for consistency with nearby Chinese labels.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR updates the Apache Doris Lakehouse documentation (dev/current) to extend the Iceberg and Paimon catalog capability matrices with explicit read capabilities for views, branches/tags, and Iceberg metadata tables, keeping EN and zh-CN pages structurally aligned.

Changes:

  • Add READ_VIEW capability rows under the View capability group for both Iceberg and Paimon matrices.
  • Add BRANCH_READ and TAG_READ capability rows under the Branch / Tag capability group for both matrices.
  • Add READ_METADATA_TABLE under a new “Metadata Table” capability group for the Iceberg matrix.

Checkpoint Assessment

  • Goal & satisfaction: The diffs implement the stated goal by adding the requested capability rows and adjusting rowSpan values accordingly.
  • Scope & focus: Changes are narrowly scoped to the capability matrices without unrelated rewrites.
  • Information architecture & sync: Current/dev docs are updated for both English and Chinese counterparts as described; however, one newly added label in zh-CN remains untranslated (see comment).
  • Links/routing/sidebars: No paths/slugs/sidebar items changed in this PR, so no navigation updates are applicable.
  • Docusaurus/MDX correctness: The table edits appear structurally consistent (row counts match updated rowSpan values in reviewed hunks).
  • Validation coverage: No automated tests are applicable for doc-only MDX changes; review is based on structural inspection of the edited table regions.
  • Other usability/accessibility/maintainability: Minor localization consistency issue in the zh-CN Iceberg matrix for the newly added “Metadata Table” group label.
File summaries
File Description
docs/lakehouse/best-practices/doris-paimon-capability-matrix.mdx Adds READ_VIEW, BRANCH_READ, and TAG_READ rows and updates related rowSpan values.
docs/lakehouse/best-practices/doris-iceberg-capability-matrix.mdx Adds READ_VIEW, BRANCH_READ, TAG_READ, and READ_METADATA_TABLE rows and updates related rowSpan values.
i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-paimon-capability-matrix.mdx Mirrors the English Paimon matrix additions and rowSpan updates for zh-CN.
i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-iceberg-capability-matrix.mdx Mirrors the English Iceberg matrix additions; one new group label needs localization for consistency.
Review details
  • Files reviewed: 4/4 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

<td align="center">✅</td>
</tr>
<tr>
<td>Metadata Table</td>
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.

2 participants