jiangxt2 commented on code in PR #13187: URL: https://github.com/apache/gravitino/pull/13187#discussion_r4037366181
########## docs/lance-rest-integration.md: ########## @@ -57,6 +57,31 @@ The following table outlines the tested compatibility between Gravitino versions - The Lance ecosystem is changing quickly, so some versions may introduce breaking changes. ::: +## Format boundary + +The Lance REST service is a Lance table namespace, even when its metadata backend is a +format-agnostic Generic Catalog. The REST table operations therefore validate the stored +`format` property before returning Lance metadata or applying a table mutation. + +When an identifier is occupied by a known non-Lance table, direct Lance table operations fail +with HTTP `400` and an `INVALID_INPUT` error. `TableExists` presents that entry as absent and +returns the normal table-not-found response. The underlying Generic Catalog metadata and storage +location remain unchanged. + +The same boundary applies to create requests that target an existing entity through the Lance +delegator: + +| Request mode | Existing non-Lance entity | +| --- | --- | Review Comment: OK, done. -- 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]
