Hi everyone,

I propose adding the CatalogObjectIdentifier schema to the REST catalog
OpenAPI spec.
PR: https://github.com/apache/iceberg/pull/16144

Summary:

   - CatalogObjectIdentifier is an ordered list of hierarchical levels (a
   JSON array of strings) that identifies any catalog object, such as a table,
   view, materialized view, namespace, or function.
   - Structurally the same as Namespace; the distinct name signals
   "any catalog object" rather than specifically a namespace path.
   - The kind of object an identifier refers to is determined by context
   (the endpoint, or a companion type discriminator defined by that endpoint),
   not by the identifier structure itself.


Motivation: multiple concurrent efforts need a generic catalog-object
identifier and would otherwise each introduce their own

   - events endpoint (#12584),
   - resolve endpoint  (#15830),
   - functions endpoint (#15180).


Adding one shared schema avoids identifier proliferation as new object
types are added to the spec.

Please review the PR and vote in the next 72 hours.

[ ] +1 Add CatalogObjectIdentifier to the REST OpenAPI spec
[ ] +0
[ ] -1 Do not add CatalogObjectIdentifier because...

Only PMC members have binding votes, but other community members
are encouraged to cast non-binding votes. This vote will pass if there are
3 binding +1 votes and more binding +1 votes than -1 votes.

Thanks,
Steven

Dev thread: https://lists.apache.org/thread/w6r3cvj483n4fsb5js84smwg8331stbs
Design doc:
https://docs.google.com/document/d/1NTQhgNbP2dkIMuXUMA5JdwliVQKCp1TU_ux5J_AaPiw/edit?tab=t.0
Java impl: https://github.com/apache/iceberg/pull/16160

Reply via email to