Fokko commented on code in PR #1500:
URL: https://github.com/apache/iceberg-python/pull/1500#discussion_r1958406030
##########
mkdocs/docs/api.md:
##########
@@ -1194,6 +1194,24 @@ with table.update_spec() as update:
update.rename_field("bucketed_id", "sharded_id")
```
+## Sort order updates
+
+Users can update the sort order on existing tables for new data. See
[sorting](https://iceberg.apache.org/spec/#sorting) for more details.
+
+The API to use when updating a sort order is the `update_sort_order` API on
the table.
+
+Sort orders can only be updated by adding a new sort order. They cannot be
deleted or modified.
Review Comment:
Yes, this is the case today. There are some efforts going on right now
around removing old schemas and partition specs, but if you do this, you want
to make sure that there is no reference anymore to the partition spec in the
metadata tree. Often you don't see that many sort orders, since it is less
likely than adding a new field, so it isn't a problem that you cannot remove
them.
--
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-unsubscr...@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org
For additional commands, e-mail: issues-h...@iceberg.apache.org
