这些设置可在 system.settings 中查看,并根据 源代码 自动生成。
hdfs_create_new_file_on_insert
类型
Bool
默认值
0
启用或禁用在 HDFS 引擎表 中每次 insert 时创建新文件的功能。如果启用,每次 insert 时都会创建一个新的 HDFS 文件,文件名类似以下 pattern:
初始:data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gz,以此类推。
Possible values:
- 0 —
INSERT查询会将新数据追加到文件末尾。 - 1 —
INSERT查询会创建一个新文件。
hdfs_ignore_file_doesnt_exist
类型
Bool
默认值
0
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.6 | 0 | 在 HDFS 表引擎中,如果请求的文件不存在,则允许返回 0 行,而不是抛出异常 |
读取某些键对应的文件时,如果文件不存在,则忽略其缺失。
Possible values:
- 1 —
SELECT返回空结果。 - 0 —
SELECT抛出异常。
hdfs_replication
类型
UInt64
默认值
0
实际的副本数量可以在创建 HDFS 文件时指定。
hdfs_skip_empty_files
类型
Bool
默认值
0
启用或禁用在 HDFS 引擎表中跳过空文件。
可能的值:
- 0 — 如果空文件与所请求的格式不兼容,
SELECT会抛出异常。 - 1 — 对于空文件,
SELECT返回空结果。
hdfs_throw_on_zero_files_match
类型
Bool
默认值
0
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.6 | 0 | 允许在 ListObjects 请求无法在 HDFS 引擎中匹配到任何文件时抛出错误,而不是返回空查询结果 |
如果根据 glob 展开规则未匹配到任何文件,则抛出错误。
可能的值:
- 1 —
SELECT抛出异常。 - 0 —
SELECT返回空结果。
hdfs_truncate_on_insert
类型
Bool
默认值
0
启用或禁用在 HDFS 引擎表中执行插入前的截断操作。如果禁用,当 HDFS 中的文件已存在时,尝试插入会抛出异常。
可能的值:
- 0 —
INSERT查询会将新数据追加到文件末尾。 - 1 —
INSERT查询会用新数据替换文件的现有内容。