system.settings
引入或更新于：v1.2.745
存储当前会话的系统设置。
SELECT * FROM system.settings;
name |value |default |level |description |type |
--------------------------------------------+------------+------------+-------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------+
acquire_lock_timeout |30 |30 |SESSION|设置获取表锁的最大超时时间（秒）。如果在此时间内无法获取锁，查询将失败。 |UInt64|
allow_query_exceeded_limit |0 |0 |SESSION|允许查询短暂超出配置的内存限制，延迟错误通知直到实际发生内存争用。 |UInt64|
binary_input_format |utf-8 |utf-8 |SESSION|控制字符串字面量插入 BINARY 列时的解释方式。可选值："hex"、"base64"、"utf-8"、"utf-8-lossy"。 |String|
binary_output_format |hex |hex |SESSION|控制 BINARY 列在查询结果中的渲染方式。可选值："hex"、"base64"、"utf-8"、"utf-8-lossy"。 |String|
collation |binary |binary |SESSION|设置字符排序规则。可选值为 "binary" 和 "utf8"。 |String|
copy_dedup_full_path_by_default |0 |0 |SESSION|启用 COPY 去重的默认全路径匹配。 |UInt64|
data_retention_num_snapshots_to_keep |0 |0 |SESSION|指定 VACUUM 操作期间保留的快照数量。设置为非零值时覆盖 data_retention_time_in_days。有效范围：0–500。 |UInt64|
date_format_style |MySQL |MySQL |SESSION|设置日期时间函数的日期格式样式。可选值："MySQL"（使用 %Y, %m 格式）和 "Oracle"（使用 YYYY, MM 格式以兼容标准 SQL）。 |String|
ddl_column_type_nullable |1 |1 |SESSION|在创建或修改表时，列是否默认为可空。 |UInt64|
deduplicate_label | | |SESSION|SQL 写操作去重标签。设置后，Databend 使用此标签检测并跳过重复的写操作，用于实现幂等写入。 |String|
default_order_by_null |nulls_last |nulls_last |SESSION|控制 ORDER BY 结果中 NULL 值的默认位置（未显式指定 NULLS FIRST/NULLS LAST 时）。可选值："nulls_first"、"nulls_last"、"nulls_first_on_asc_last_on_desc"、"nulls_last_on_asc_first_on_desc"。 |String|
efficiently_memory_group_by |0 |0 |SESSION|高效使用内存，但这可能会导致性能下降。 |UInt64|
enable_aggregating_index_scan |1 |1 |SESSION|在查询（Query）时启用对聚合索引（Aggregating Index）数据的扫描。 |UInt64|
enable_auto_detect_datetime_format |0 |0 |SESSION|启用日期时间格式自动检测，用于解析日期时间字符串。 |UInt64|
enable_block_stream_write |1 |1 |SESSION|启用数据摄取的 block stream write 模式。 |UInt64|
enable_bushy_join |0 |0 |SESSION|启用查询优化器（Query Optimizer）生成 bushy join 计划。 |UInt64|
enable_cbo |1 |1 |SESSION|启用基于成本的优化（Cost-Based Optimization）。 |UInt64|
enable_dio |1 |1 |SESSION|启用存储读取的 Direct I/O，绕过操作系统页面缓存。可通过避免双重缓冲来提升大型顺序扫描的性能。 |UInt64|
enable_distributed_compact |0 |0 |SESSION|启用表的分布式压缩（Compaction）执行。 |UInt64|
enable_distributed_copy_into |0 |0 |SESSION|启用 copy into 的分布式执行。 |UInt64|
enable_distributed_merge_into |0 |0 |SESSION|启用 merge into 的分布式执行。 |UInt64|
enable_distributed_recluster |0 |0 |SESSION|启用表的分布式 recluster 执行。 |UInt64|
enable_distributed_replace_into |0 |0 |SESSION|启用 replace into 的分布式执行。 |UInt64|
enable_dphyp |1 |1 |SESSION|启用 dphyp 连接顺序算法。 |UInt64|
enable_experimental_merge_into |0 |0 |SESSION|启用实验性的 merge into。 |UInt64|
enable_experimental_row_access_policy |0 |0 |SESSION|启用实验性的行访问策略（Row Access Policy）功能。使用 Row Access Policy 相关语句需要开启此设置。 |UInt64|
enable_experimental_virtual_column |0 |0 |SESSION|启用实验性的虚拟列（Virtual Column）功能。 |UInt64|
enable_geo_create_table |0 |0 |SESSION|启用地理表的创建功能。 |UInt64|
enable_hive_parquet_predict_pushdown |1 |1 |SESSION|将此变量设置为 1 以启用 Hive Parquet 谓词下推（Predicate Pushdown），默认值：1。 |UInt64|
enable_last_snapshot_location_hint |1 |1 |SESSION|启用在每次写入后向存储写入 last_snapshot_location_hint 对象。该提示通过提供最新快照的快捷方式来加速表的打开。 |UInt64|
enable_parquet_page_index |1 |1 |SESSION|启用 Parquet 页面索引。 |UInt64|
enable_parquet_prewhere |0 |0 |SESSION|启用 Parquet prewhere。 |UInt64|
enable_parquet_rowgroup_pruning |1 |1 |SESSION|启用 Parquet 行组修剪（Rowgroup Pruning）。 |UInt64|
enable_query_profiling |0 |0 |SESSION|启用查询（Query）性能分析记录。 |UInt64|
enable_query_result_cache |0 |0 |SESSION|启用查询（Query）结果缓存（Cache）以提高相同查询（Query）的性能。 |UInt64|
enable_recluster_after_write |1 |1 |SESSION|在写入（copy/replace-into）后启用重新聚簇（Reclustering）。 |UInt64|
enable_refresh_aggregating_index_after_write|0 |0 |SESSION|新数据写入后刷新聚合索引（Aggregating Index）。 |UInt64|
enable_replace_into_bloom_pruning |1 |1 |SESSION|为 replace-into 语句启用布隆过滤器修剪（Bloom Pruning）。 |UInt64|
enable_replace_into_partitioning |1 |1 |SESSION|为 replace-into 语句启用分区（Partition）（如果表有聚簇键（Cluster Key））。 |UInt64|
enable_result_set_spilling |0 |0 |SESSION|启用结果集数据溢出到存储，当内存使用超过阈值时，避免因结果集过大导致内存不足错误。 |UInt64|
enable_runtime_filter |0 |0 |SESSION|为 JOIN 启用运行时过滤器（Runtime Filter）优化。 |UInt64|
enable_strict_datetime_parser |1 |1 |SESSION|启用严格的日期时间解析。开启后，无效的日期时间字符串将导致错误，而不是静默转换。 |UInt64|
enable_table_lock |1 |1 |SESSION|在必要时启用表锁（Table Lock）（默认启用）。 |UInt64|
error_on_nondeterministic_update |1 |1 |SESSION|启用后，当 UPDATE 语句中包含非确定性表达式时抛出错误。 |UInt64|
external_server_connect_timeout_secs |10 |10 |SESSION|连接到外部 UDF 服务器的超时时间（秒）。 |UInt64|
external_server_request_batch_rows |65536 |65536 |SESSION|发送到外部 UDF 服务器的每批行数。 |UInt64|
external_server_request_max_threads |256 |256 |SESSION|用于外部 UDF 服务器请求的最大线程数。 |UInt64|
external_server_request_retry_times |8 |8 |SESSION|外部 UDF 服务器请求失败后的重试次数。 |UInt64|
external_server_request_timeout_secs |180 |180 |SESSION|单次外部 UDF 服务器请求的超时时间（秒）。 |UInt64|
flight_client_timeout |60 |60 |SESSION|设置 Flight 客户端请求可以被处理的最大时间（秒）。 |UInt64|
format_null_as_str |1 |1 |SESSION|在查询结果中将 NULL 值格式化为字符串。 |UInt64|
group_by_shuffle_mode |before_merge|before_merge|SESSION|Group by 的 shuffle 模式，'before_partial' 更均衡，但需要交换更多数据。 |String|
group_by_two_level_threshold |20000 |20000 |SESSION|设置 GROUP BY 操作中触发两级聚合（Two-Level Aggregation）的键的数量。 |UInt64|
hide_options_in_show_create_table |1 |1 |SESSION|在 SHOW TABLE CREATE 结果的末尾隐藏与表相关的信息，如 SNAPSHOT_LOCATION 和 STORAGE_FORMAT。 |UInt64|
hive_parquet_chunk_size |16384 |16384 |SESSION|每次从 Parquet 读取到 Databend 处理器的最大行数。 |UInt64|
http_handler_result_timeout_secs |60 |60 |SESSION|HTTP 查询结果处理的超时时间（秒）。 |UInt64|
http_json_result_mode |display |display |SESSION|控制 HTTP 查询 JSON 结果的编码方式。可选值："display"（人类可读格式）、"driver"（驱动程序优化格式）。 |String|
idle_transaction_timeout_secs |14400 |14400 |SESSION|空闲事务的超时时间（秒）。超过此空闲时间的事务将被自动回滚。 |UInt64|
input_read_buffer_size |4194304 |4194304 |SESSION|设置分配给缓冲读取器用于从存储中读取数据的缓冲区内存大小（字节）。 |UInt64|
join_spilling_threshold |0 |0 |SESSION|哈希连接可使用的最大内存量，0 表示无限制。 |UInt64|
lazy_read_threshold |1000 |1000 |SESSION|设置查询（Query）中启用延迟读取优化的最大 LIMIT。设置为 0 将禁用此优化。 |UInt64|
load_file_metadata_expire_hours |12 |12 |SESSION|设置使用 COPY INTO 加载数据的文件元数据的过期时间（小时）。 |UInt64|
max_block_size |65536 |65536 |SESSION|设置可读取的单个数据块的最大字节大小。 |UInt64|
max_cte_recursive_depth |1000 |1000 |SESSION|设置 CTE 递归查询的最大递归深度。 |UInt64|
max_execute_time_in_seconds |0 |0 |SESSION|设置查询（Query）执行的最大时间（秒）。设置为 0 表示无限制。 |UInt64|
max_inlist_to_or |3 |3 |SESSION|设置 IN 表达式中可包含并转换为 OR 运算符的最大值的数量。 |UInt64|
max_memory_usage |6871947673 |6871947673 |SESSION|设置处理单个查询（Query）的最大内存使用量（字节）。 |UInt64|
max_query_memory_usage |0 |0 |SESSION|单个查询的最大内存使用量。设置为 0 表示无限制。注意：max_memory_usage 也可用于相同目的。 |UInt64|
max_result_rows |0 |0 |SESSION|当未指定特定行数时，设置查询（Query）结果中可返回的最大行数。设置为 0 表示无限制。 |UInt64|
max_storage_io_requests |48 |48 |SESSION|设置并发 I/O 请求的最大数量。 |UInt64|
max_threads |8 |8 |SESSION|设置执行请求的最大线程数。 |UInt64|
max_vacuum_temp_files_after_query |0 |u64::MAX |SESSION|查询完成后移除的最大临时文件数。设置为 0 可禁用查询后的自动临时文件清理。默认值：无限制 (u64::MAX)。需要启用 vacuum 功能。 |UInt64|
max_vacuum_threads |1 |1 |SESSION|执行 VACUUM 操作的最大线程数。范围：1–3。 |UInt64|
numeric_cast_option |rounding |rounding |SESSION|设置数字转换模式为 "rounding"（四舍五入）或 "truncating"（截断）。 |String|
parquet_fast_read_bytes |0 |0 |SESSION|较小的 Parquet 文件将作为整个文件读取，而不是逐列读取。 |UInt64|
parquet_uncompressed_buffer_size |2097152 |2097152 |SESSION|设置用于读取 Parquet 文件的缓冲区大小（字节）。 |UInt64|
prefer_broadcast_join |1 |1 |SESSION|启用广播连接。 |UInt64|
purge_duplicated_files_in_copy |0 |0 |SESSION|在 COPY INTO 操作过程中清除重复文件。 |UInt64|
query_flight_compression |LZ4 |LZ4 |SESSION|设置 Flight 查询结果的压缩算法。可选值："LZ4"、"ZSTD"、"NONE"。 |String|
query_out_of_memory_behavior |throw |throw |SESSION|控制查询超过内存限制时的行为。可选值："throw"（立即抛出错误）、"spilling"（将数据溢出到磁盘）。 |String|
query_result_cache_allow_inconsistent |0 |0 |SESSION|确定 Databend 是否返回与底层数据不一致的缓存查询（Query）结果。 |UInt64|
query_result_cache_max_bytes |1048576 |1048576 |SESSION|设置单个查询（Query）结果缓存的最大字节大小。 |UInt64|
query_result_cache_ttl_secs |300 |300 |SESSION|设置缓存查询（Query）结果的生存时间（TTL）（秒）。一旦缓存结果的 TTL 过期，该结果将被视为陈旧，不会用于新查询（Query）。 |UInt64|
quoted_ident_case_sensitive |1 |1 |SESSION|确定 Databend 是否将带引号的标识符（Identifier）视为区分大小写。 |UInt64|
random_function_seed |0 |0 |SESSION|设置随机函数的初始种子值。设置为 0 表示使用随机种子。 |UInt64|
recluster_block_size |2405181685 |2405181685 |SESSION|设置用于重新聚簇的块的最大字节大小。 |UInt64|
recluster_timeout_secs |43200 |43200 |SESSION|设置重新聚簇最终超时的秒数。 |UInt64|
replace_into_bloom_pruning_max_column_number|4 |4 |SESSION|replace-into 语句中布隆过滤器修剪使用的最大列数。 |UInt64|
replace_into_shuffle_strategy |0 |0 |SESSION|0 表示块级 shuffle，1 表示段级 shuffle。 |UInt64|
retention_period |12 |12 |SESSION|设置保留期（小时）。 |UInt64|
s3_storage_class | | |SESSION|设置写入 S3 兼容对象存储时使用的 S3 存储类别。可选值："STANDARD"、"INTELLIGENT_TIERING"。默认值：继承自服务器配置。 |String|
sandbox_tenant | | |SESSION|向此会话注入自定义的 'sandbox_tenant'。这仅用于测试目的，并且仅在 'internal_enable_sandbox_tenant' 开启时生效。 |String|
script_max_steps |10000 |10000 |SESSION|单个 SQL 脚本执行（EXECUTE IMMEDIATE / 存储过程）中允许的最大步骤（语句）数。用于防止脚本失控。 |UInt64|
spilling_bytes_threshold_per_proc |0 |0 |SESSION|设置在查询（Query）执行期间，聚合器在将数据溢出（Spilling）到存储之前可以使用的最大内存量（字节）。 |UInt64|
spilling_memory_ratio |0 |0 |SESSION|设置在查询（Query）执行期间，聚合器在将数据溢出到存储之前可以使用的最大内存比率（字节）。 |UInt64|
sql_dialect |PostgreSQL |PostgreSQL |SESSION|设置 SQL 方言。可选值为 "PostgreSQL"、"MySQL" 和 "Hive"。 |String|
statement_queue_ttl_in_seconds |15 |15 |SESSION|语句在查询队列中等待的最大生存时间（秒）。 |UInt64|
statement_queued_timeout_in_seconds |0 |0 |SESSION|语句等待入队的最大超时时间（秒）。设置为 0 表示无超时限制。 |UInt64|
storage_fetch_part_num |2 |2 |SESSION|设置在查询（Query）执行期间从存储中并行获取的分区（Partition）数量。 |UInt64|
storage_io_max_page_bytes_for_read |524288 |524288 |SESSION|设置在单个 I/O 操作中可以从存储中读取的数据页的最大字节大小。 |UInt64|
storage_io_min_bytes_for_seek |48 |48 |SESSION|设置在数据文件中寻址新位置时，单个 I/O 操作必须从存储中读取的最小数据字节大小。 |UInt64|
storage_read_buffer_size |1048576 |1048576 |SESSION|设置用于将数据读入内存的缓冲区大小（字节）。 |UInt64|
timezone |Japan |UTC |GLOBAL |设置时区。 |String|
stream_consume_batch_size_hint |0 |0 |SESSION|Stream 消费操作的批处理大小提示。 |UInt64|
table_lock_expire_secs |5 |5 |SESSION|设置表锁过期的秒数。 |UInt64|
trace_sample_rate |1 |1 |SESSION|分布式追踪的采样率百分比。范围：0–100。设置为 0 禁用追踪，100 追踪所有查询。 |UInt64|
udf_cloud_import_presign_expire_secs |259200 |259200 |SESSION|云 UDF Stage 导入的预签名 URL 过期时间（秒）。 |UInt64|
unquoted_ident_case_sensitive |0 |0 |SESSION|确定 Databend 是否将不带引号的标识符视为区分大小写。 |UInt64|
use_parquet2 |1 |1 |SESSION|在 infer_schema() 时使用 parquet2 而不是 parquet_rs。 |UInt64|
week_start |1 |1 |SESSION|指定一周的第一天（用于与周相关的日期函数）。0 代表星期日，1 代表星期一。 |UInt64|
