Skip to main content

All Variables

Complete list of session variables available via SET and SHOW.

General

VariableDefaultDescription
search_path"$user", publicSchema search order for unqualified names
timezoneEtc/UTCTime zone for displaying and interpreting timestamps
session_timezone(empty)User-provided session timezone name (e.g., America/Los_Angeles)
adjust_timestamp_to_session_timezonefalseAdjust timezone-less timestamp conversions to the session timezone
datestyleISO, MDYDisplay format for date and time values
intervalstylepostgresDisplay format for interval values
client_encodingUTF8Client character set encoding
server_encodingUTF8Server character set encoding (read-only)
server_version18.1Server version (read-only)
application_name(empty)Application name reported in logs
standard_conforming_stringsonCauses '...' strings to treat backslashes literally

Transactions

VariableDefaultDescription
default_transaction_isolationrepeatable readIsolation level for new transactions
transaction_isolationrepeatable readCurrent transaction's isolation level
default_transaction_read_onlyoffDefault read-only status of new transactions

SereneDB-Specific

VariableDefaultDescription
sdb_write_conflict_policyemit_errorWrite conflict policy: emit_error, do_nothing (skip conflicted rows), or replace
sdb_read_your_own_writestrueWhether queries see uncommitted writes from the current transaction

Query Execution

VariableDefaultDescription
execution_threads0Number of threads for query execution. 0 means serial execution in the connection thread
join_order_algorithmcostJoin ordering algorithm: cost (default), greedy, or syntactic
query_max_memory_per_node0BMaximum memory per query per host. 0 means unlimited
task_writer_count4Number of parallel table writer operators per task
task_partitioned_writer_count4Number of parallel table writer operators for partitioned writes
min_table_rows_for_parallel_join_build1000Minimum table rows to trigger parallel hash join build

Numeric Formatting

VariableDefaultDescription
extra_float_digits1Number of extra digits displayed for floating-point values
bytea_outputhexOutput format for bytea: hex or escape
integer_datetimesonWhether datetimes are integer-based (read-only)

Expression Evaluation

VariableDefaultDescription
expression.eval_simplifiedfalseUse the simplified expression evaluation path
expression.track_cpu_usagefalseTrack CPU usage for individual expressions. Can be expensive for small batches
expression.max_array_size_in_reduce100000Maximum array size allowed in reduce()
expression.max_compiled_regexes100Maximum compiled regex patterns per function instance per thread
track_operator_cpu_usagetrueTrack CPU usage for individual operator stages
legacy_castfalseUse legacy CAST operator behavior
cast_match_struct_by_namefalseMatch struct fields by name instead of position during CAST
adaptive_filter_reordering_enabledtrueReorder conjunction inputs based on evaluation time
hash_adaptivity_enabledtrueAllow adaptive hash mode in GROUP BY
enable_expression_evaluation_cachetrueEnable caches in expression evaluation for performance

Spilling

Controls for spilling data to disk when memory is exceeded.

VariableDefaultDescription
spill_enabledfalseGlobal spilling flag
aggregation_spill_enabledtrueAggregation spilling (requires spill_enabled)
join_spill_enabledtrueJoin spilling (requires spill_enabled)
order_by_spill_enabledtrueORDER BY spilling (requires spill_enabled)
window_spill_enabledtrueWindow function spilling (requires spill_enabled)
writer_spill_enabledtrueTable writer spilling (requires spill_enabled)
row_number_spill_enabledtrueROW_NUMBER spilling (requires spill_enabled)
topn_row_number_spill_enabledtrueTop-N ROW_NUMBER spilling (requires spill_enabled)
local_merge_spill_enabledfalseLocal merge spilling (requires spill_enabled)
max_spill_run_rows12582912Max rows per spill run (~128 MB). 0 means no limit
max_spill_bytes107374182400Max total spill bytes per query (default 100 GB). 0 means no limit
max_spill_level1Max recursive spill levels. -1 means no limit
max_spill_file_size0Max spill file size. 0 means no limit
spill_compression_codecnoneCompression codec for spilled data
spill_write_buffer_size1048576Spill write buffer size in bytes
spill_read_buffer_size1048576Spill read buffer size in bytes

Batch Sizing

VariableDefaultDescription
preferred_output_batch_bytes10485760Preferred output batch size in bytes
preferred_output_batch_rows1024Preferred output batch row count (used when row size is unknown)
max_output_batch_rows10000Maximum output batch row count
max_output_buffer_size33554432Maximum task output buffer size in bytes
table_scan_getoutput_time_limit_ms5000Table scan time limit per getOutput() call in ms. 0 means no limit

Exchange & Partitioning

VariableDefaultDescription
max_local_exchange_buffer_size33554432Max local exchange buffer size before backpressure
max_local_exchange_partition_count4294967295Max local exchange partitions
exchange.max_buffer_size33554432Max ExchangeQueue buffer size in bytes
merge_exchange.max_buffer_size134217728Max merge exchange buffer size in bytes
max_page_partitioning_buffer_size33554432Max PartitionedOutput buffer size in bytes

Aggregation

VariableDefaultDescription
max_partial_aggregation_memory16777216Max memory for partial aggregation
max_extended_partial_aggregation_memory67108864Max extended memory for partial aggregation
abandon_partial_aggregation_min_rows100000Min rows before abandoning partial aggregation
abandon_partial_aggregation_min_pct80Min reduction percentage before abandoning partial aggregation

Query Tracing

VariableDefaultDescription
query_trace_enabledfalseEnable query tracing
query_trace_dir(empty)Directory for query trace data
query_trace_node_id(empty)Plan node ID to trace
query_trace_max_bytes0Max trace bytes. 0 disables tracing

Debug

These settings are for debugging only and may impact performance.

VariableDefaultDescription
debug.validate_output_from_operatorsfalseValidate output vectors of every operator
debug_disable_expression_with_peelingfalseDisable dictionary peeling optimization
debug_disable_common_sub_expressionsfalseDisable common sub-expression caching
debug_disable_expression_with_memoizationfalseDisable expression memoization
debug_disable_expression_with_lazy_inputsfalseDisable lazy input loading