paimon icon indicating copy to clipboard operation
paimon copied to clipboard

[core] Introduce 'file-io.atomic-rename.enabled' for atomic rename control

Open lsm1 opened this issue 2 months ago • 0 comments

Purpose

Add a new configuration option file-io.atomic-rename.enabled to control whether to attempt atomic rename for file overwrite operations.

When enabled (default), Paimon attempts to use atomic rename (write to temp file then rename with OVERWRITE option) via reflection on the FileSystem's 3-parameter rename method. This is supported on distributed file systems like HDFS (DistributedFileSystem). On object storage systems like S3/OSS that don't implement this method, it automatically falls back to direct overwrite.

When disabled, Paimon skips the atomic rename attempt and always uses direct overwrite, which can avoid the overhead of reflection calls and temporary file operations, especially useful on object storage systems where atomic rename is not supported.

Tests

API and Format

Documentation

lsm1 avatar Nov 10 '25 07:11 lsm1