[I] [kafka] Define DDL table mapping for Kafka compatibility [fluss]

["gyang94 (via GitHub)" <gi...@apache.org>]

gyang94 opened a new issue, #4275:
URL: https://github.com/apache/fluss/issues/4275

   ### Parent issue
   
   Part of #4185 — Kafka Protocols Compatibility: Basic Produce.
   
   ### Motivation
   
   Define the DDL table mapping contract before Metadata and Produce so both APIs agree on which Fluss tables can be exposed as Kafka topics and how records map to physical columns. This is PR03 in the foundation sequence; Metadata is PR04 (#4266).
   
   ### Scope
   
   - Map a topic name to the same-named table in the configured Kafka database, table IDs to stable topic IDs, and Kafka partitions to Fluss buckets.
   - Define the initial supported table shape: non-partitioned Arrow log tables without a primary key.
   - Resolve `kafka.*` custom properties for raw/string key and value formats, field projections, and optional timestamp/headers columns.
   - Validate field names, types, projection conflicts, and unsupported mapping options through a shared resolver that Metadata and later Produce can reuse.
   - Cover valid/invalid mappings and a native Fluss create-table → metadata-readback round trip.
   
   ### Acceptance criteria
   
   - [ ] The mapping is defined by the existing table schema and custom properties, without a mandatory four-column envelope.
   - [ ] Valid raw/string mappings resolve deterministically; invalid table kinds, fields, types and overlapping projections are rejected.
   - [ ] Topic identity remains stable during a table lifetime and changes when the table is recreated.
   - [ ] Mapping properties survive native Fluss table creation and metadata retrieval.
   - [ ] Relevant unit/integration tests, style and license checks pass, and the focused implementation is reviewed and merged.
   
   ### Dependencies
   
   Depends on #4265, which builds on #4264. This issue is a prerequisite for Metadata (#4266) and subsequent Produce capabilities.
   
   ### Out of scope
   
   Kafka CreateTopics/DeleteTopics, automatic table creation, Metadata request handling, Produce, byte decoding, Arrow encoding, JSON conversion, and authentication.
   
   ### Implementation and review
   
   The implementation is prepared locally on `codex/kafka-ddl-table-mapping`; its implementation PR is pending publication. Local Java 11 validation passed 47 unit tests and 2 integration tests, including the native DDL round trip, plus Checkstyle, Spotless and RAT checks. These results do not imply remote CI or review completion.
   


-- 
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: issues-unsubscribe@fluss.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [I] [kafka] Define DDL table mapping for Kafka compatibility [fluss]

["wuchong (via GitHub)" <gi...@apache.org>]

wuchong closed issue #4275: [kafka] Define DDL table mapping for Kafka compatibility
URL: https://github.com/apache/fluss/issues/4275


-- 
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: issues-unsubscribe@fluss.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org