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]

Reply via email to