Skip to content

Docs: Update information about metrics mode #16391

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
psvri wants to merge 3 commits into
base: main
Choose a base branch
from
+10 −2
Open

Docs: Update information about metrics mode #16391

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
11f9400
Docs: Update information about metrics mode
psvri May 18, 2026
043ade3
Update docs/docs/configuration.md
psvri May 19, 2026
b184f57
Fix lint
psvri May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 10 additions & 2 deletions docs/docs/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand All @@ -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. Metrics modes are explained below:
- `none`: In this mode, `value_counts`, `null_value_counts`, `nan_value_counts`, `lower_bounds`, and `upper_bounds` are not persisted.
- `counts`: In this mode, `value_counts`, `null_value_counts`, and `nan_value_counts` are persisted.
- `truncate(length)`: In this mode, `value_counts`, `null_value_counts`, `nan_value_counts`, truncated `lower_bounds`, and truncated `upper_bounds` are persisted. Only string and binary values are truncated to the specified length. For other types, values are written as is.
- `full`: In this mode, `value_counts`, `null_value_counts`, `nan_value_counts`, full `lower_bounds`, and full `upper_bounds` are persisted.

Comment thread
psvri marked this conversation as resolved.
### Encryption properties

| Property | Default | Description |
Expand Down