You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@iceberg.apache.org by huaxin gao <hu...@gmail.com> on 2025/09/29 15:54:29 UTC
[VOTE] “Iceberg REST Catalog Idempotency” (Spec)
Hi all,
I’d like to start a VOTE to adopt the Iceberg REST Catalog Idempotency
proposal.
*Motivation:* Mutation retries can double-apply or corrupt metadata after
transient failures. This spec makes retries safe and interoperable.
*Summary:*
-
Optional Idempotency-Key for mutation endpoints only
-
First request wins; duplicates return the original finalized result
-
Scope: key is unique within *(operation type, resource id)*
-
Discovery via idempotency-key-lifetime (ISO-8601)
-
Backwards-compatible; server internals not prescribed
-
*Details:*
-
Proposal doc:
https://docs.google.com/document/d/1WyiIk08JRe8AjWh63txIP4i2xcIUHYQWFrF_1CCS3uw/edit?tab=t.0#heading=h.jfecktgonj1i
-
Spec PR: https://github.com/apache/iceberg/pull/14196
-
Discuss thread:
https://lists.apache.org/thread/y91scqfd1g3yd0owbgzrr1d2hm3w78gy
*Please vote within 72 hours:*
[ ] +1 Add these changes to the spec
[ ] +0
[ ] -1 I have questions and/or concerns
Best,
Huaxin
Re: [VOTE] “Iceberg REST Catalog Idempotency” (Spec)
Posted by huaxin gao <hu...@gmail.com>.
Hi Yufei,
Thanks for the suggestion. I’ll pause this vote until we get more reviews
on the PR(https://github.com/apache/iceberg/pull/14196), then start a new
72-hour vote. I’ll also ping likely reviewers on the PR.
Best,
Huaxin
On Mon, Sep 29, 2025 at 1:56 PM Yufei Gu <fl...@gmail.com> wrote:
> Hi Huaxin,
>
> Thanks a lot for working on it. I'm supportive of the proposal. Can we
> give people a bit more time for the PR(
> https://github.com/apache/iceberg/pull/14196) review given that nobody
> hasn't commented on it.
>
> Yufei
>
>
> On Mon, Sep 29, 2025 at 9:16 AM huaxin gao <hu...@gmail.com> wrote:
>
>> Hi all,
>>
>> I’d like to start a VOTE to adopt the Iceberg REST Catalog Idempotency
>> proposal.
>>
>> *Motivation:* Mutation retries can double-apply or corrupt metadata
>> after transient failures. This spec makes retries safe and interoperable.
>>
>> *Summary:*
>>
>> -
>>
>> Optional Idempotency-Key for mutation endpoints only
>> -
>>
>> First request wins; duplicates return the original finalized result
>> -
>>
>> Scope: key is unique within *(operation type, resource id)*
>> -
>>
>> Discovery via idempotency-key-lifetime (ISO-8601)
>> -
>>
>> Backwards-compatible; server internals not prescribed
>>
>>
>> -
>>
>> *Details:*
>>
>> -
>>
>> Proposal doc:
>> https://docs.google.com/document/d/1WyiIk08JRe8AjWh63txIP4i2xcIUHYQWFrF_1CCS3uw/edit?tab=t.0#heading=h.jfecktgonj1i
>> -
>>
>> Spec PR: https://github.com/apache/iceberg/pull/14196
>> -
>>
>> Discuss thread:
>> https://lists.apache.org/thread/y91scqfd1g3yd0owbgzrr1d2hm3w78gy
>>
>>
>> *Please vote within 72 hours:*
>>
>> [ ] +1 Add these changes to the spec
>> [ ] +0
>> [ ] -1 I have questions and/or concerns
>>
>> Best,
>>
>> Huaxin
>>
>>
Re: [VOTE] “Iceberg REST Catalog Idempotency” (Spec)
Posted by Yufei Gu <fl...@gmail.com>.
Hi Huaxin,
Thanks a lot for working on it. I'm supportive of the proposal. Can we give
people a bit more time for the PR(
https://github.com/apache/iceberg/pull/14196) review given that nobody
hasn't commented on it.
Yufei
On Mon, Sep 29, 2025 at 9:16 AM huaxin gao <hu...@gmail.com> wrote:
> Hi all,
>
> I’d like to start a VOTE to adopt the Iceberg REST Catalog Idempotency
> proposal.
>
> *Motivation:* Mutation retries can double-apply or corrupt metadata after
> transient failures. This spec makes retries safe and interoperable.
>
> *Summary:*
>
> -
>
> Optional Idempotency-Key for mutation endpoints only
> -
>
> First request wins; duplicates return the original finalized result
> -
>
> Scope: key is unique within *(operation type, resource id)*
> -
>
> Discovery via idempotency-key-lifetime (ISO-8601)
> -
>
> Backwards-compatible; server internals not prescribed
>
>
> -
>
> *Details:*
>
> -
>
> Proposal doc:
> https://docs.google.com/document/d/1WyiIk08JRe8AjWh63txIP4i2xcIUHYQWFrF_1CCS3uw/edit?tab=t.0#heading=h.jfecktgonj1i
> -
>
> Spec PR: https://github.com/apache/iceberg/pull/14196
> -
>
> Discuss thread:
> https://lists.apache.org/thread/y91scqfd1g3yd0owbgzrr1d2hm3w78gy
>
>
> *Please vote within 72 hours:*
>
> [ ] +1 Add these changes to the spec
> [ ] +0
> [ ] -1 I have questions and/or concerns
>
> Best,
>
> Huaxin
>
>