> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# delta_lake_* 会话设置

> delta_lake_* 自动生成分组中的 ClickHouse 会话设置。

这些设置可在 [system.settings](https://clickhouse.com/docs/zh/reference/system-tables/settings.md) 中查看，由 [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) 自动生成。

## delta\_lake\_accurate\_write\_cast

类型

Bool

默认值

1

写入 DeltaLake 表时，使用精确转换将每个值转换为 Delta 写入 schema 类型。如果值不适合目标类型，精确转换会引发异常，而普通转换会静默截断值 (例如，将 `300` 写入 Delta 的 `byte` 列) 。如需使用普通的非异常转换，请设为 `false`，或使用低于 26.9 的 `compatibility` 设置。

## delta\_lake\_enable\_engine\_predicate

类型

Bool

默认值

1

启用 delta-kernel 的内部数据裁剪。

## delta\_lake\_enable\_expression\_visitor\_logging

类型

Bool

默认值

0

启用 DeltaLake 表达式访问器的测试级别日志。即使在测试日志中，这些日志也可能过于冗长。

## delta\_lake\_insert\_max\_bytes\_in\_data\_file

类型

NonZeroUInt64

默认值

1073741824

定义 Delta Lake 中单个插入数据文件的字节数上限。

## delta\_lake\_insert\_max\_rows\_in\_data\_file

类型

NonZeroUInt64

默认值

1000000

定义 Delta Lake 中单个写入数据文件的行数上限。

## delta\_lake\_log\_metadata

类型

Bool

默认值

0

启用将 Delta Lake 元数据文件记录到系统表中。

## delta\_lake\_reload\_schema\_for\_consistency

类型

Bool

默认值

0

启用后，会在每次查询执行前从 DeltaLake 元数据 重新加载 schema，以确保
查询分析期间使用的 schema 与执行期间使用的 schema 一致。

## delta\_lake\_snapshot\_end\_version

类型

Int64

默认值

-1

要读取的 Delta Lake 快照 的结束版本。值 -1 表示读取最新版本 (值 0 也是有效的 快照 version) 。

## delta\_lake\_snapshot\_start\_version

类型

Int64

默认值

-1

要读取的 delta lake 快照起始版本。值为 -1 表示读取最新版本 (0 是有效的快照版本值) 。

## delta\_lake\_snapshot\_version

类型

Int64

默认值

-1

要读取的 Delta Lake 快照版本。值 -1 表示读取最新版本 (值 0 是有效的快照版本) 。

## delta\_lake\_throw\_on\_engine\_predicate\_error

类型

Bool

默认值

0

启用后，如果在 delta-kernel 中分析扫描谓词时出错，则会抛出异常。
