rdblue commented on code in PR #13810:
URL: https://github.com/apache/iceberg/pull/13810#discussion_r2747132351
##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -980,6 +980,30 @@ 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 namespaces follow the same
+ encoding rules as the `parent` parameter in the list namespaces
endpoint (using `namespace-separator`
+ as defined in `/config`).
+
+ The namespace and view name are separated by a dot. When parsing,
the dot separator is located by
+ finding the first dot character after the last namespace separator.
+
+ Multiple view identifiers are separated by commas. Servers should
split the parameter value on comma characters
+ to parse individual view identifiers. If view names contain
commas, they must be url-coded as %2C.
+
+ Example with multiple views (where prod%1Fanalytics refers to a
nested namespace) -
prod%1Fanalytics.quarterly_view,prod%1Fanalytics.monthly_view
Review Comment:
For this example, it would help to also use it as an opportunity to clarify
the order of views. I think that this is a quarterly view that references
monthly views that reference the table being loaded.
--
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]
