dimas-b commented on code in PR #10877:
URL: https://github.com/apache/iceberg/pull/10877#discussion_r1709441061
##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -222,7 +222,8 @@ paths:
description:
An optional namespace, underneath which to list namespaces.
If not provided or empty, all top-level namespaces should be
listed.
- If parent is a multipart namespace, the parts must be separated by
the unit separator (`0x1F`) byte.
+ If parent is a multipart namespace, the parts must be separated by
the namespace separator as
+ indicated via the /config override `rest-namespace-separator`,
which defaults to the unit separator (`0x1F`) byte.
Review Comment:
This approach will break old client in environments where the server is able
to accept the non-printable separator, but chooses to use an alternative
separator.
So, the upgrade path for users would be to first upgrade clients, then use
new servers. As for me, it can be a significant burden on users. Also, this
will require that new clients be API-compatible with older servers during the
transition period... WDYT?
--
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
