Skip to content

feat: add global system tables framework under sys database#366

Open
suxiaogang223 wants to merge 10 commits into
alibaba:mainfrom
suxiaogang223:codex/global-system-tables
Open

feat: add global system tables framework under sys database#366
suxiaogang223 wants to merge 10 commits into
alibaba:mainfrom
suxiaogang223:codex/global-system-tables

Conversation

@suxiaogang223

@suxiaogang223 suxiaogang223 commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Summary

Add global system table support under the sys database, enabling catalog-level metadata queries.

Closes part of #141.

Changes

Infrastructure

  • Add GetOptions() to Catalog interface for catalog-level config access
  • FileSystemCatalog stores and exposes catalog options
  • New GlobalSystemTableLoader with independent registry for sys tables
  • Extend SystemTablePath with is_global flag and TryParsePath to detect sys/ paths
  • FileSystemCatalog handles sys database in ListTables/DatabaseExists/TableExists/LoadTableSchema

Global System Tables

Table Status Columns
sys.catalog_options ✅ Complete key, value
sys.all_table_options ✅ Complete database_name, table_name, key, value
sys.tables ✅ Complete database_name, table_name, table_type, partitioned, primary_key, record_count, file_size_in_bytes, file_count, last_file_creation_time
sys.partitions ✅ Complete database_name, table_name, partition_name, record_count, file_size_in_bytes, file_count, last_update_time

Integration Tests (4 new tests in SystemTableReadInteTest)

  • TestReadGlobalCatalogOptions — verifies schema + content
  • TestReadGlobalAllTableOptions — verifies table options across databases
  • TestReadGlobalTables — verifies schema, table metadata
  • TestReadGlobalPartitions — verifies empty result for unpartitioned tables

Files Changed

 include/paimon/catalog/catalog.h                   |   5 +
 src/paimon/CMakeLists.txt                          |   1 +
 src/paimon/core/catalog/catalog.cpp                |   2 +-
 src/paimon/core/catalog/file_system_catalog.cpp    |  39 +-
 src/paimon/core/catalog/file_system_catalog.h      |   6 +-
 .../core/table/system/global_system_tables.cpp     | 370 ++++++++++++++
 .../core/table/system/global_system_tables.h       | 117 +++++
 src/paimon/core/table/system/system_table.cpp      |  28 +-
 src/paimon/core/table/system/system_table.h        |   2 +
 .../core/catalog/file_system_catalog_test.cpp      |  14 +-
 test/inte/read_inte_test.cpp                       | 237 +++++++++
 11 files changed, 810 insertions(+), 10 deletions(-)

Verification

Fedora x86_64, GCC 16:

  • Build: ✅
  • paimon-core-test: 36/40 pass (4 failures pre-existing)
  • paimon-read-inte-test (global tables): 4/4 ✅
  • paimon-read-inte-test (system tables): same as before

🤖 Generated with Claude Code

suxiaogang223 and others added 6 commits July 2, 2026 16:44
- Add GetOptions() to Catalog interface for catalog-level config access
- FileSystemCatalog stores and exposes catalog_options
- New GlobalSystemTableLoader with independent registry for sys tables
- Implement sys.catalog_options, sys.all_table_options, sys.tables
- Stub for sys.partitions (manifest aggregation to follow)
- Extend SystemTablePath with is_global flag
- TryParsePath detects sys/ paths for TableScan/TableRead routing
- FileSystemCatalog handles sys database in ListTables, DatabaseExists,
  TableExists, LoadTableSchema

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@suxiaogang223 suxiaogang223 force-pushed the codex/global-system-tables branch from e4597fa to 92de892 Compare July 2, 2026 08:45
suxiaogang223 and others added 2 commits July 2, 2026 16:58
Replace the TODO stubs in TablesSystemTable::BuildRows() with actual
manifest entry aggregation. The new AggregateFileStats() helper reads
the latest snapshot data files and computes record_count, file_size,
file_count, and last_file_creation_time.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Replace the stub with actual partition-level file statistics using the
AggregateFileStats helper. For each partitioned table, read manifest
entries and emit one row per partition with record_count, file_size,
file_count, and last_update_time.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@suxiaogang223 suxiaogang223 marked this pull request as ready for review July 2, 2026 12:29
Add 4 tests to SystemTableReadInteTest:
- TestReadGlobalCatalogOptions: verifies sys.catalog_options schema and content
- TestReadGlobalAllTableOptions: verifies sys.all_table_options with table options
- TestReadGlobalTables: verifies sys.tables schema, table_type, partitioned, pk
- TestReadGlobalPartitions: verifies sys.partitions returns empty for unpartitioned

Tests use a ReadGlobalSystemTable helper that creates the
GlobalSystemTableContext with a proper Catalog pointer.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@suxiaogang223 suxiaogang223 force-pushed the codex/global-system-tables branch from 55828f8 to c5d3439 Compare July 2, 2026 13:00
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.

1 participant