dhruvarya-db commented on code in PR #17642:
URL: https://github.com/apache/iceberg/pull/17642#discussion_r4545399653
##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -1299,6 +1304,91 @@ paths:
5XX:
$ref: '#/components/responses/ServerErrorResponse'
+ /v2/{prefix}/namespaces/{namespace}/tables/{table}:
+ parameters:
+ - $ref: '#/components/parameters/prefix'
+ - $ref: '#/components/parameters/namespace'
+ - $ref: '#/components/parameters/table'
+
+ get:
+ tags:
+ - Catalog API
+ summary: Load a table from the catalog
+ operationId: loadTableV2
+ description:
+ Load a table from the catalog.
+
+
+ This endpoint returns the same response as the v1 `loadTable` endpoint
and may return a table at any format version, including format version 4.
+ Clients that support format version 4 should load tables through this
endpoint.
+
+
+ The response contains both configuration and table metadata. The
configuration, if non-empty is used
+ as additional configuration for the table that overrides catalog
configuration. For example, this
+ configuration may change the FileIO implementation to be used for the
table.
+
+
+ The response also contains the table's full metadata, matching the
table metadata JSON file.
+
+
+ The catalog configuration may contain credentials that should be used
for subsequent requests for the
+ table. The configuration key "token" is used to pass an access token
to be used as a bearer token
+ for table requests. Otherwise, a token may be passed using a RFC 8693
token type as a configuration
+ key. For example, "urn:ietf:params:oauth:token-type:jwt=<JWT-token>".
+ parameters:
+ - $ref: '#/components/parameters/data-access'
+ - name: If-None-Match
+ in: header
+ description:
+ An optional header that allows the server to return 304 (Not
Modified) if the metadata
+ is current. The content is the value of the ETag received in a
CreateTableResponse,
+ LoadTableResponse or CommitTableResponse.
+ required: false
+ schema:
+ type: string
+ - in: query
+ name: snapshots
+ description:
+ The snapshots to return in the body of the metadata via the
`snapshots` field. Setting
+ the value to `all` would return the full set of snapshots
currently valid for the table.
+ Setting the value to `refs` would load all snapshots referenced by
branches or tags.
+
Review Comment:
Makes sense. I also did the same for `table-location`
--
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]
