This is an automated email from the ASF dual-hosted git repository.
pvary pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iceberg.git
The following commit(s) were added to refs/heads/main by this push:
new 46ae3ad274 Docs: Update information about metrics mode (#16391)
46ae3ad274 is described below
commit 46ae3ad2749cdcb7877d86babd0357b42f05823b
Author: Vrishabh <[email protected]>
AuthorDate: Thu May 21 11:14:27 2026 +0530
Docs: Update information about metrics mode (#16391)
---
docs/docs/configuration.md | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)
diff --git a/docs/docs/configuration.md b/docs/docs/configuration.md
index 17bf1f8ac0..fbcab4832a 100644
--- a/docs/docs/configuration.md
+++ b/docs/docs/configuration.md
@@ -68,8 +68,8 @@ Iceberg tables support table properties to configure table
behavior, like the de
| write.location-provider.impl | null
| Optional custom implementation for LocationProvider
|
| write.metadata.compression-codec | none
| Metadata compression codec; none or gzip
|
| write.metadata.metrics.max-inferred-column-defaults | 100
| Defines the maximum number of columns for which metrics are collected.
Columns are included with a pre-order traversal of the schema: top level fields
first; then all elements of the first nested struct; then the next nested
struct and so on. |
-| write.metadata.metrics.default | truncate(16)
| Default metrics mode for all columns in the table; none, counts,
truncate(length), or full
|
-| write.metadata.metrics.column.col1 | (not set)
| Metrics mode for column 'col1' to allow per-column tuning; none, counts,
truncate(length), or full
|
+| write.metadata.metrics.default | truncate(16)
| Default metrics mode for all columns in the table; none, counts,
truncate(length), or full [1]
|
+| write.metadata.metrics.column.col1 | (not set)
| Metrics mode for column 'col1' to allow per-column tuning; none, counts,
truncate(length), or full [1]
|
| write.target-file-size-bytes | 536870912 (512 MB)
| Controls the size of files generated to target about this many bytes
|
| write.delete.target-file-size-bytes | 67108864 (64 MB)
| Controls the size of delete files generated to target about this many
bytes
|
| write.distribution-mode | not set, see engines
for specific defaults, for example [Spark
Writes](spark-writes.md#writing-distribution-modes) | Defines distribution of
write data: __none__: don't shuffle rows; __hash__: hash distribute by
partition key ; __range__: range distribute by partition key or sort key if
table has an SortOrder |
@@ -93,6 +93,14 @@ Iceberg tables support table properties to configure table
behavior, like the de
| write.merge.isolation-level | serializable
| Isolation level for merge commands: serializable or snapshot
|
| write.delete.granularity | partition
| Controls the granularity of generated delete files: partition or file
|
+Notes:
+
+1. Available metrics modes:
+ - none: No metrics are persisted
+ - counts: Only count metrics are persisted (value_counts,
null_value_counts, nan_value_counts).
+ - truncate(length): Persists counts plus truncated bounds (lower_bounds,
upper_bounds). Truncation applies only to string and binary types; all other
types are stored as-is.
+ - full: Persists all metrics, including full lower_bounds and upper_bounds.
+
### Encryption properties
| Property | Default | Description
|
