语句行为
SQL语句执行过程中的对象搜索顺序、执行超时控制、数据缓存与IO调度、结果集输出格式以及日志级别等行为,均会影响查询效率和问题定位的便利性。本节介绍控制SQL语句执行行为的GUC参数,包括模式搜索路径(search\_path)、语句超时(statement\_timeout)、磁盘缓存与异步IO、运行时过滤(runtime filter)、结果集格式、日志级别等。您可以根据业务特点调整这些参数,优化查询性能并满足监控与排障需求。
参数说明
| 参数 | 参数类型 | 说明 |
|---|---|---|
| search_path | String | 参数解释:当一个被引用对象没有指定模式时,此参数设置模式搜索顺序。它的值由一个或多个模式名构成,不同的模式名用逗号隔开。
取值范围:字符串。
默认值:无 |
| current_schema | String | 参数解释:设置当前的模式。 取值范围:字符串。 默认值:default_db。 |
| statement_timeout | Integer | 参数解释:当语句执行时间超过该参数设置的时间(从服务器收到命令时开始计时)时,该语句将会报错并退出执行。 取值范围:整型,0~2147483647,单位为毫秒(ms)。 默认值:0。 |
| bytea_output | Enum | 参数解释:设置bytea类型值的输出格式。 取值范围:枚举型。 - hex:将二进制数据编码为每字节2位十六进制数字。 - escape:传统的PostgreSQL格式。采用以ASCII字符序列表示二进制串的方法,同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列。 默认值:hex。 |
| enable_disk_cache | Boolean | 参数解释:设置是否打开磁盘缓存和数据预读,当前数据预取仅对PARQUET/ORC格式文件有效,磁盘缓存对所有格式文件均有效。 取值范围:布尔型。 - on:打开磁盘缓存和数据预取。 - off:关闭磁盘缓存和数据预取。 默认值:on。 |
| disk_cache_max_size | Integer | 参数解释:用于设置磁盘缓存的总大小。 取值范围:整型,512MB~1PB。 默认值:5GB。 |
| enable_aio_scheduler | Boolean | 参数解释:控制是否开启异步IO调度,该IO调度是异步读写的基础。 取值范围:
默认值:on。 |
| runtime_filter_type | String | 参数解释:标识使用的runtime filter类型。 取值范围:字符串。
默认值:min_max, bloom_filter, global_filter, topn_filter。 |
| enable_meta_scan | Boolean | 参数解释:Iceberg查询时是否打开metaScan。 取值范围:
默认值:true。 |
| enable_spill_to_remote_storage | Boolean | 参数解释:控制是否打开spill-to-obs特性开关,为true时表示开启特性,下盘数据会被disk cache管控,并在空间不足时使用OBS作为逃生通道;为false时表示使用旧的下盘方式,直接写到本地EVS中。该参数存在参数依赖,当打开spill-to-obs特性开关enable_spill_to_remote_storage时,use_yr_as_block_cache_backend开关必须为false。 取值范围:
默认值:true |
| enable_remote_cache | Boolean | 参数解释:控制SQL是否使用Cache服务作为跨语句的缓存,为true时表示使用Cache服务;为false时表示不使用跨语句的缓存。参数类型:POSTMASTER。 取值范围:bool。 默认值:false |
| staging_folder_expire_time | Integer | 参数解释:控制ORC、PARQUET表临时文件目录残留后的自动清理周期,默认七天后自动清理。 取值范围:int64,取值范围12h~1year。 默认值:604800。 |
| obs_result_format | Integer | 参数解释:控制向OBS写入结果集文件时的格式,以及是否启动结果集文件压缩功能。参数类型:USERSET。 取值范围:
默认值:0。 |
| resource_track_level | Enum | 参数解释:控制SQL监控数据中query_plan字段上报的信息类型,当前只对select、insert、delete、update、create table as语句生效。参数类型:USERSET。 取值范围:枚举型。
默认值:perf。 |
| external_partition_pruning_method | Enum | 参数解释:控制ORC、PARQUET表分区读取方式。参数类型:USERSET。 取值范围:枚举型。
默认值:partition_list。 |
| reader_opt_options | String | 参数解释:标识使用的查询过滤增强选项。 取值范围:字符串,可以同时设置多个。
默认值:parquet_pushdown, iceberg_pushdown, partition_dynamic_pruning, dictionary, complex_type_pushdown, remove_duplicate_filter, page_index, parquet_native_decoder, dict_filter_row, balance_file_size。 |
| log_min_messages | Enum | 参数解释:控制写到服务器日志文件中的消息级别。参数类型:USERSET。 取值范围:枚举型,有效值有debug5、debug4、debug3、debug2、debug1、info、notice、warning、error、log、fatal、panic。每个级别包含其后所有的级别,级别越靠后,发送到日志的消息越少。例如log在log_min_messages中的级别在error之后,log级别时只能打印log、fatal、panic三种日志到服务器日志文件中。 默认值:warning。 |
| enable_topsql_to_collector | Boolean | 参数解释:控制后台常驻的性能指标采集上报线程是否启动。 取值范围:布尔型。
默认值:false。 |