apache / apache/polaris

Support Idempotency-Key in Iceberg REST Catalog API

Open
#2,606 2 comments 0 reactions 0 assignees View on GitHub
enhancement proposal
Dominant language
Java
Stars
2.1k
Forks
522
Avg merge
1d 22h
Merged PRs (30d)
137

Description

### Is your feature request related to a problem? Please describe.

IETF draft: https://datatracker.ietf.org/doc/html/draft-ietf-httpapi-idempotency-key-header-06

Iceberg proposal (author: @huaxingao):
* doc: https://docs.google.com/document/d/1WyiIk08JRe8AjWh63txIP4i2xcIUHYQWFrF_1CCS3uw/edit?tab=t.0#heading=h.jfecktgonj1i
* email: https://lists.apache.org/thread/y91scqfd1g3yd0owbgzrr1d2hm3w78gy

### Describe the solution you'd like

Polaris proposal (author: @huaxingao):
* doc: https://docs.google.com/document/d/1L5A8Cspugsk1dW4Ij4dy5wB5FKa8KnaXT0LHBJdgq9w/edit?tab=t.0
* email: https://lists.apache.org/thread/3n26zfs31oqs8f85st4j7dq7c5sy47h8

### Describe alternatives you've considered

See email discussions.

### Additional context

_No response_

Contributor guide

Open the contributing guide

Research direction

Read the linked IETF Idempotency-Key draft and the Iceberg and Polaris proposal documents first, then inspect the REST Catalog API entry points. Use the proposal and email discussions to establish the expected behavior and acceptance criteria; done means the agreed Idempotency-Key support is implemented consistently across the API.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
api, backend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.