Package org.apache.polaris.service.idempotency

Interface IdempotencyConfiguration

@ConfigMapping(prefix="polaris.idempotency") public interface IdempotencyConfiguration
Deploy-time configuration for entity-property (single-transaction) idempotency.

This model embeds the Idempotency-Key directly into the internalProperties of the entity created by the originating operation, so the key and the operation commit atomically. There is no separate idempotency store, so the configuration surface is intentionally minimal: just a feature flag and the key TTL.

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    enabled()
    Whether handler-level idempotency is enabled.
    Duration
    ttl()
    TTL for newly recorded idempotency keys.

  • Method Details

    • enabled

      @WithDefault("false") boolean enabled()
      Whether handler-level idempotency is enabled. When false the handlers ignore the Idempotency-Key header entirely and never stamp or read idempotency keys.

    • ttl

      @WithDefault("PT5M") Duration ttl()
      TTL for newly recorded idempotency keys. A retry that arrives within this window of a successful create replays the existing table; after it elapses the key is treated as absent and dropped inline on the entity's next write.