nevzheng opened a new pull request, #12074:
URL: https://github.com/apache/gravitino/pull/12074

   ### What changes were proposed in this pull request?
   
   Define and document Flink compatibility for the five Gravitino V3-native 
type families.
   
   | Type family | Outcome |
   | --- | --- |
   | Nanosecond timestamps | Round-trip exact precision-9 timestamp values. |
   | Variant | Reject because the supported Flink versions do not provide an 
equivalent Variant contract. |
   | Unknown/Null | Round-trip nullable Unknown through Flink NULL; reject 
unsupported non-null use. |
   | Geometry | Reject because CRS metadata cannot be preserved. |
   | Geography | Reject because CRS and edge-algorithm metadata cannot be 
preserved. |
   
   ### Why are the changes needed?
   
   Flink conversion previously lacked a complete, explicit contract for the new 
V3-native families. This change prevents silent coercion while preserving the 
mappings Flink can represent exactly.
   
   Fix: #12058
   
   Related: #12056
   
   ### Does this PR introduce _any_ user-facing change?
   
   Yes. Exact timestamp and nullable Unknown mappings are supported, while 
unsupported V3-native types fail explicitly before catalog mutation.
   
   ### How was this patch tested?
   
   - Added focused `TypeUtils` and catalog-create conversion coverage.
   - Covered Flink 1.18, 1.19, and 1.20.
   - Covered exact round trips and pre-mutation rejection paths.
   - Updated `docs/flink-connector/flink-connector.md`.
   


-- 
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