nastra commented on code in PR #13810:
URL: https://github.com/apache/iceberg/pull/13810#discussion_r2685489570
##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -980,6 +980,32 @@ paths:
schema:
type: string
enum: [ all, refs ]
+ - in: query
+ name: referenced-by
+ description:
+ A comma-separated list of fully qualified view names (namespace
and view name) representing the view
+ reference chain when a table is loaded via a view. The list should
be ordered with the outermost view
+ first, followed by any intermediate views it references, down to
the view that directly references the table.
+ For a simple case where a view directly references the table, the
list contains a single view identifier.
+ For nested views (a view referencing another view which references
the table), the list contains multiple
+ view identifiers representing the complete dependency chain.
+
+ Each view identifier has the format namespace.viewName where
multipart namespace parts must be separated
+ by the namespace separator as indicated via the /config override
namespace-separator, which defaults to
+ the unit separator 0x1F byte (url encoded %1F). To be compatible
with older clients, servers must use
+ both the advertised separator and 0x1F as valid separators when
decoding namespaces.
+ The namespace-separator should be provided in a url encoded form.
Review Comment:
```suggestion
The `namespace-separator` should be provided in a url encoded
form.
```
those comments are so that we're consistent across the OpenAPI spec on how
we highlight fields
--
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]
