You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@iceberg.apache.org by "nastra (via GitHub)" <gi...@apache.org> on 2024/08/14 09:06:01 UTC
[I] REST Endpoint Discovery [iceberg]
nastra opened a new issue, #10937:
URL: https://github.com/apache/iceberg/issues/10937
### Proposed Change
# Motivation
The Iceberg OpenAPI REST specification defines a set of endpoints with their request and response definitions and describes how these endpoints need to be implemented by Iceberg REST clients and servers.
Adding new functionality to the REST specification often entails the addition of new endpoints. However, Iceberg REST clients currently don’t have any knowledge about whether such new endpoints are supported by a REST server implementing the Iceberg REST specification.
Such a scenario can result in ambiguous error responses on the REST client and require additional error handling ([#9754](https://github.com/apache/iceberg/pull/9754), [#9853](https://github.com/apache/iceberg/pull/9853)) in order to not break functionality when using such new features with engines like Spark.
This proposal allows a server to communicate to clients what endpoints it supports via a new endpoints field in the [CatalogConfig](https://github.com/apache/iceberg/blob/6319712b612b724fedbc5bed41942ac3426ffe48/open-api/rest-catalog-open-api.yaml#L1564) of the [v1/config](https://github.com/apache/iceberg/blob/6319712b612b724fedbc5bed41942ac3426ffe48/open-api/rest-catalog-open-api.yaml#L65-L130) endpoint. This enables clients to make better decisions and clearly signal that a particular endpoint isn’t supported.
Proposal doc: https://docs.google.com/document/d/1krcIaLfxtBFDABU5ssLmf64zyHgE8BRncpGPIMTWlxo/edit?usp=sharing
# Goals
* Allow a server to communicate to clients what endpoints it supports
* Allow clients to avoid calling unsupported endpoints
# Non-Goals
* OpenAPI REST Specification versioning
### Proposal document
https://docs.google.com/document/d/1krcIaLfxtBFDABU5ssLmf64zyHgE8BRncpGPIMTWlxo/edit?usp=sharing
### Specifications
- [ ] Table
- [ ] View
- [X] REST
- [ ] Puffin
- [ ] Encryption
- [ ] Other
--
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-unsubscribe@iceberg.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [I] REST Endpoint Discovery [iceberg]
Posted by "nastra (via GitHub)" <gi...@apache.org>.
nastra commented on issue #10937:
URL: https://github.com/apache/iceberg/issues/10937#issuecomment-2288481864
https://github.com/apache/iceberg/pull/10928 / https://github.com/apache/iceberg/pull/10929
--
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-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [I] REST Endpoint Discovery [iceberg]
Posted by "nastra (via GitHub)" <gi...@apache.org>.
nastra closed issue #10937: REST Endpoint Discovery
URL: https://github.com/apache/iceberg/issues/10937
--
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-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org
Re: [I] REST Endpoint Discovery [iceberg]
Posted by "nastra (via GitHub)" <gi...@apache.org>.
nastra commented on issue #10937:
URL: https://github.com/apache/iceberg/issues/10937#issuecomment-2419812419
this is done
--
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-unsubscribe@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org