wiki/duckdb/duckdb_variables-zh.md
[ DuckDB Engine Variables in AliSQL | AliSQL DuckDB 引擎参数 ]
duckdb_modeON 时启用，NONE 表示不启用。该参数为只读参数，只能在启动时指定。duckdb_require_primary_key说明：DuckDB 表中实际不会创建任何索引，主键/唯一键的唯一性需要用户来保证。当构建 DuckDB 节点作为从节点时，请务必开启此参数以确保数据复制的正确性。
duckdb_memory_limit说明：当启用 DuckDB 引擎时，建议降低 innodb_buffer_pool_size 的配置，以释放更多内存给 DuckDB 存储引擎使用。
duckdb_temp_directoryduckdb_max_temp_directory_sizeduckdb_temp_directory 所在目录中 DuckDB 可使用的最大磁盘空间。0 表示由系统自动决定，通常为磁盘空间的 90%。duckdb_threadsduckdb_use_direct_io说明：当前 DuckDB Direct I/O 模式并不稳定，不建议使用。
duckdb_scheduler_process_partialduckdb_merge_join_thresholdduckdb_convert_all_at_startupduckdb_convert_all_at_startup_ignore_errorduckdb_convert_all_at_startup_threadsduckdb_convert_all_skip_mtr_dbmtr 的数据库。此参数一般情况下只用于辅助通过测试用例。该参数为只读参数，只能在实例启动前配置。duckdb_force_no_collationON，以提升性能。duckdb_source_set_insert_only_to_binloginsert_only 标志，以优化复制性能。duckdb_explain_outputEXPLAIN 命令输出的默认格式。可选值包括全部计划、优化后计划或物理执行计划。duckdb_multi_trx_in_batchduckdb_multi_trx_timeoutduckdb_multi_trx_max_batch_lengthduckdb_commit_multi_trx_due_to_readerduckdb_commit_multi_trx_due_to_rotateduckdb_commit_multi_trx_due_to_rotate_frequencyduckdb_commit_multi_trx_due_to_rotate 启用时，每接收多少个 binlog rotate 事件后提交一次。0 表示从不，1 表示每次都提交。该参数仅在备节点生效。duckdb_copy_ddl_threadsinnodb_parallel_read_threads的控制。duckdb_checkpoint_thresholdduckdb_use_double_for_decimal说明：该参数影响列的实际类型，实例创建后不应更改。
duckdb_disabled_optimizersduckdb_data_import_mode说明
- 适用于批量导入场景，将多次的插入/删除操作合并为一次批量操作，提高导入性能。
- 此参数在事务中无法修改。
- 此参数为 ON 时，修改的表要求必须具备主键。
- 此参数为 ON 时，将无法执行 update 操作，请将 update 操作转换为 delete + insert 操作。
- 此参数为 ON 时，不满足条件的 DML 操作将会报错。
- 只有参数
duckdb_dml_in_batch开始，此参数才会生效。
duckdb_idempotent_data_import_enabledduckdb_data_import_mode为 ON 时，是否启用幂等数据导入。启用后，重复导入相同数据（如重启恢复）不会导致数据重复。说明：开启幂等数据导入功能后，数据导入性能会有一定程度的下降。
duckdb_appender_allocator_flush_thresholdduckdb_log_optionsforce_innodb_to_duckdbduckdb_copy_ddl_in_batchduckdb_dml_in_batch说明：
- 开启此参数后，DuckDB 节点作为从节点且当主节点的 binlog 格式为 row 时，DuckDB 引擎会自动完成所有 DML 操作的攒批。
- 开启此参数后，DuckDB 主节点上的插入操作可以攒批，删除操作能否攒批依赖参数
duckdb_data_import_mode的开关及其限制，更新操作无法攒批。
update_modified_column_only