lucasfang opened a new pull request, #556:
URL: https://github.com/apache/paimon-cpp/pull/556
### Purpose
Linked issue: closes #555. Related to #459 and #533.
Operation Contexts still duplicate the table identity and storage
configuration already bound to a loaded Table. Separate loading, table options
and execution settings on the Table hierarchy merged in #527.
- Add `TableLoadOptions` and a shared loading path for the four static
operator factories.
- Make Contexts execution-only. Loaded tables expose
`NewScan/NewRead/NewWrite/NewCommit(context)`; dynamic options are applied
through `Table::Copy(options)` before creating operators.
- Keep the original table unchanged when copying, retain catalog ownership,
UUID, storage routing and schema caches, and reject conflicting type or branch
overrides.
- Preserve query authorization, fallback reads, external format-table
directory semantics and catalog missing-table errors.
- Migrate internal callers, tests, examples, benchmarks and documentation.
Most changed files are call-site migrations.
This implements the separation proposed in #533 directly on main, with
option overrides owned by `Table::Copy`.
### Tests
Regression coverage includes:
- Context construction without table metadata I/O, invalid loading
combinations, catalog path/UUID checks and explicit filesystem precedence.
- Copy independence and chained option precedence, catalog lifetime, storage
routing and warmed schema-cache reuse.
- Managed, format and system-table operators, including audit/binlog
sequence-number output from copied tables.
- Query-auth behavior, fallback schema/storage resolution, external format
partitions named `schema` or `branch`, and distinct missing-table errors for
catalog and path loads.
- Migrated core, REST, read/write, Blob, index and compaction integration
coverage.
### API and Format
Breaking C++ API changes:
- Add exported `paimon::TableLoadOptions` and virtual
`Table::Copy(dynamic_options)`.
- Scan/Read Context builders take no table-loading arguments; Write/Commit
builders take the commit user. Remove Context paths, table schemas,
filesystems, catalogs, option maps, `WithBranch()` and FormatTable-based
constructors.
- Static factories become `Create(load_options, context, dynamic_options =
{})`.
- `Table::NewXXX(context)` remains context-only. Callers override options
with `Copy`, then create operators from the returned table.
Copies retain the loaded type, location, branch and storage binding; load
another table to select another branch. General branch switching and
historical-schema time travel are outside this change.
No storage-format or protocol changes.
### Documentation
Update public API references, catalog/format-table guides,
read/write/commit/realtime and cache/index examples, plus executable examples
and benchmark callers. Document loading parameters separately from Arrow read
projection and show option overrides through `Table::Copy`.
### Generative AI tooling
Generated-by: OpenAI Codex 0.166.0 (GPT-6)
--
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]