apache / apache/polaris

Add idempotency support for createTableStaged

Open
#4,200 3 comments 0 reactions 0 assignees View on GitHub
enhancement stale
Dominant language
Java
Stars
2.1k
Forks
522
Avg merge
2d 1h
Merged PRs (30d)
140

Description

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

The handler-level idempotency implementation defers idempotency support for the createTableStaged endpoint.
Staged tables are not persisted to the catalog, so the method can safely re-run on retry. The computed location is deterministic (based on namespace location + table name). The only differences on re-run are cosmetic (created-at timestamp and metadata UUID).
Dedicated idempotency support may still be desirable for consistency. Options include skipping idempotency entirely (since re-run is safe) or storing the location in the idempotency record to replay via buildLoadTableResponseWithDelegationCredentials.

### Describe the solution you'd like

_No response_

### Describe alternatives you've considered

_No response_

### Additional context

_No response_

Contributor guide

Open the contributing guide

Research direction

Start at the createTableStaged endpoint and trace the existing handler-level idempotency implementation, including buildLoadTableResponseWithDelegationCredentials. Decide whether safe reruns are sufficient or whether the idempotency record must retain the deterministic location; done means retries follow the selected behavior without changing the intended response.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
api, databases
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.