rdblue commented on code in PR #17137:
URL: https://github.com/apache/iceberg/pull/17137#discussion_r3555362954
##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -3120,6 +3120,13 @@ components:
AddSchemaUpdate:
allOf:
- $ref: '#/components/schemas/BaseUpdate'
+ description:
+ Adds a schema to the table. The field IDs in `schema` are assigned by
the client. The client
+ assigns them so that the schema stays consistent with the data files,
partition specs, and
+ sort orders it writes or co-commits, which reference fields by their
field ID
+ (`StructField.id`). Servers SHOULD preserve the field IDs submitted by
the client on
Review Comment:
I prefer "must" (or MUST if you must).
I don't see a good reason for a service to reassign at this point and the
client may know something the server does not. For instance, un-deleting a
column in existing data files. This isn't a very strong preference though.
--
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]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
