Parameter description: Specifies whether to enable the lightweight column-store update.
Type: USERSET
Value range: Boolean
Default value: off
There is a low probability that an error is reported when lightweight UPDATE and backend column-store AUTOVACUUM coexist. You can run ALTER TABLE to set the table-level parameter enable_column_autovacuum_garbage to off to avoid this issue. If the table-level parameter enable_column_autovacuum_garbage is set to off, the backend column-store AUTOVACUUM of the table is disabled.
Parameter description: Specifies whether to use the distributed framework for a query planner.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether the trigger can be pushed to DNs for execution.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether JOIN operation plans can be delivered to DNs for execution.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether the execution plans of GROUP BY and AGGREGATE can be delivered to DNs for execution.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether the execution plan specified in the LIMIT clause can be pushed down to DNs for execution.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: whether to enable the early stop optimization for LIMIT statements. For a LIMIT n statement, if early stop is enabled, the CN requests the DN to end the execution after receiving n pieces of data. This method is applicable to complex queries with LIMIT. This parameter is supported only by clusters of version 8.1.3.320 or later.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether the execution plan of the ORDER BY clause can be delivered to DNs for execution.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether joining with the pseudo constant is allowed. A pseudo constant indicates that the variables on both sides of a join are identical to the same constant.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies the model used for cost estimation in the application scenario. This parameter affects the distinct estimation of the expression, HashJoin cost model, estimation of the number of rows, distribution key selection during redistribution, and estimation of the number of aggregate rows.
Type: USERSET
Value range: 0, 1, 2, 3, or 4
Default value: 4
Parameter description: Specifies whether to enable various assertion checks. This parameter assists in debugging. If you are experiencing strange problems or crashes, set this parameter to on to identify programming defects. To use this parameter, the macro USE_ASSERT_CHECKING must be defined (through the configure option --enable-cassert) during the GaussDB(DWS) compilation.
Type: USERSET
Value range: Boolean
This parameter is set to on by default if GaussDB(DWS) is compiled with various assertion checks enabled.
Default value: off
Parameter description: Specifies whether the embedded test stubs for testing the distribution framework take effect. In most cases, developers embed some test stubs in the code during fault injection tests. Each test stub is identified by a unique name. The value of this parameter is a triplet that includes three values: thread level, test stub name, and error level of the injected fault. The three values are separated by commas (,).
Type: USERSET
Value range: a string indicating the name of any embedded test stub.
Default value: –1, default, default
Parameter description: Sets whether to ignore check failures (but still generates an alarm) and continues reading data. This parameter is valid only if enable_crc_check is set to on. Continuing reading data may result in breakdown, damaged data being transferred or hidden, failure of data recovery from remote nodes, or other serious problems. You are not advised to modify the settings.
Type: SUSET
Value range: Boolean
Default value: off
Parameter description: behavior type of the default table. This parameter is supported only by clusters of version 8.2.1 or later.
Type: USERSET
Value range: column_btree_index, column_high_compress, column_middle_compress, or column_low_compress
Default value: an empty string
Parameter description: Specifies whether to create a table as a column-store table by default when no storage method is specified. The value for each node must be the same. This parameter is used for tests. Users are not allowed to enable it.
Type: SUSET
Value range: Boolean
Default value: off
Parameter description: Specifies whether to forcibly generate vectorized execution plans for a vectorized execution operator if the operator's child node is a non-vectorized operator. When this parameter is set to on, vectorized execution plans are forcibly generated. When enable_force_vector_engine is enabled, no matter it is a row-store table, column-store table, or hybrid row-column store table, if the plantree does not contain scenarios that do not support vectorization, the vectorized executor is forcibly used.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies whether to deliver filter criteria for a rough check during query.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies the name of a CSV file exported when explain_perf_mode is set to run.
Type: USERSET
The value of this parameter must be an absolute path plus a file name with the extension .csv.
Value range: a string
Default value: NULL
Parameter description: Specifies the display format of the explain command.
Type: USERSET
Value range: normal, pretty, summary, and run
Default value: pretty
Parameter description: Controls the default distinct value of the join column or expression in application scenarios.
Type: USERSET
Value range: a double-precision floating point number greater than or equal to –100. Decimals may be truncated when displayed on clients.
Default value: –20
Parameter description: Specifies the maximum number of estimated rows for outer joins.
Type: USERSET
Value range: 0 or a double-precision floating point number greater than or equal to 1. Decimals may be truncated when displayed on clients.
Default value: 1.1
Parameter description: Controls the default distinct value of the filter column or expression in application scenarios.
Type: USERSET
Value range: a double-precision floating point number greater than or equal to –100. Decimals may be truncated when displayed on clients.
Default value: 200
Parameter description: Specifies whether to generate a large amount of debugging output for the LISTEN and NOTIFY commands. client_min_messages or log_min_messages must be DEBUG1 or lower so that such output can be recorded in the logs on the client or server separately.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies whether to display information about resource usage during sorting operations in logs. This parameter is available only when the macro TRACE_SORT is defined during the GaussDB(DWS) compilation. However, TRACE_SORT is currently defined by default.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies whether to detect a damaged page header that causes GaussDB(DWS) to report an error, aborting the current transaction.
Type: SUSET
Value range: Boolean
Default value: off
Parameter description: Specifies whether to enable internal testing on the data replication function.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Controls use of different estimation methods in specific customer scenarios, allowing estimated values approximating to onsite values. This parameter can control various methods simultaneously by performing AND (&) operations on the bit for each method. A method is selected if its value is not 0.
If cost_param & 1 is not set to 0, an improvement mechanism is selected for calculating a non-equi join selection rate, which is more accurate in estimation of self-join (join between two same tables). In V300R002C00 and later, cost_param & 1=0 is not used. That is, an optimized formula is selected for calculation.
When cost_param & 2 is set to a value other than 0, the selection rate is estimated based on multiple filter criteria. The lowest selection rate among all filter criteria, but not the product of the selection rates for two tables under a specific filter criterion, is used as the total selection rate. This method is more accurate when a close correlation exists between the columns to be filtered.
When cost_param & 4 is not 0, the selected debugging model is not recommended when the stream node is evaluated.
When cost_param & 16 is not 0, the model between fully correlated and fully uncorrelated models is used to calculate the comprehensive selection rate of two or more filtering conditions or join conditions. If there are many filtering conditions, the strongly-correlated model is preferred.
Type: USERSET
Value range: an integer ranging from 1 to INT_MAX
Default value: 16
Parameter description: Specifies the implicit conversion priority, which determines whether to preferentially convert strings into numbers.
Type: USERSET
Value range: Boolean
Default value: on
Modify this parameter only when absolutely necessary because the modification will change the rule for converting internal data types and may cause unexpected results.
Parameter description: Specifies the default timestamp format.
Type: USERSET
Value range: a string
Default value: DD-Mon-YYYY HH:MI:SS.FF AM
Parameter description: Specifies whether to select an intelligent algorithm for joining partitioned tables.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies whether dynamic pruning is enabled during partition table scanning.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies the maximum number of exceptions. The default value cannot be changed.
Type: USERSET
Value range: an integer
Default value: 1000
Parameter description: This parameter no longer takes effect.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies the current statistics mode. This parameter is used to compare global statistics generation plans and the statistics generation plans for a single DN. This parameter is used for tests. Users are not allowed to enable it.
Type: SUSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether to enable optimization for numeric data calculation. Calculation of numeric data is time-consuming. Numeric data is converted into int64- or int128-type data to improve numeric data calculation performance.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies the format in which numeric data in a row-store table is spilled to disks.
Type: USERSET
Value range: Boolean
If this parameter is set to on, you are advised to enable enable_force_vector_engine to improve the query performance of large data sets. However, compared with the original format, there is a high probability that the bigint format occupies more disk space. For example, the TPC-H test set occupies about 7% more space (reference value, may vary depending on the environment).
Default value: off
Parameter description: Specifies the rewriting rule for enabled optional queries. Some query rewriting rules are optional. Enabling them cannot always improve query efficiency. In a specific customer scenario, you can set the query rewriting rules through the GUC parameter to achieve optimal query efficiency.
This parameter can control the combination of query rewriting rules, for example, there are multiple rewriting rules: rule1, rule2, rule3, and rule4. To set the parameters, you can perform the following operations:
set rewrite_rule=rule1; --Enable query rewriting rule rule1. set rewrite_rule=rule2,rule3; --Enable query rewriting rules rule2 and rule3. set rewrite_rule=none; --Disable all optional query rewriting rules.
Type: USERSET
Value range: a string
Default value: magicset, or_conversion, projection_pushdown, plain_lazyagg, or subquery_qual_pull_up
Parameter description: whether to enable the rewriting rule for the materialized view.
Type: USERSET
Value range: a string
Default value: text, general, and predicate
general, predicate, and view_delta are restricted for commercial use. To use them, contact technical support.
Parameter description: Specifies whether to enable the compression function of writing data to a disk.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether to enable corresponding features, such as data validation and performance statistics.
Type: USERSET
Value range: a string
Default value: off(ALL), which indicates that no location function is enabled.
Parameter description: Specifies the log level of self-diagnosis. Currently, this parameter takes effect only in multi-column statistics.
Type: USERSET
Value range: a string
Currently, the two parameter values differ only when there is an alarm about multi-column statistics not collected. If the parameter is set to summary, such an alarm will not be displayed. If it is set to detail, such an alarm will be displayed.
Default value: summary
Parameter description: Specifies the number of buckets for HLL data. The number of buckets affects the precision of distinct values calculated by HLL. As the number of buckets increases, the deviation becomes smaller. The deviation range is as follows: [–1.04/2log2m*1/2, +1.04/2log2m*1/2]
Type: USERSET
Value range: an integer ranging from 10 to 16
Default value: 11
Parameter description: Specifies the number of bits in each bucket for HLL data. A larger value indicates more memory occupied by HLL. hll_default_regwidth and hll_default_log2m determine the maximum number of distinct values that can be calculated by HLL. For details, see Table 1.
Type: USERSET
Value range: an integer ranging from 1 to 5
Default value: 5
log2m |
regwidth = 1 |
regwidth = 2 |
regwidth = 3 |
regwidth = 4 |
regwidth = 5 |
|---|---|---|---|---|---|
10 |
7.4e+02 |
3.0e+03 |
4.7e+04 |
1.2e+07 |
7.9e+11 |
11 |
1.5e+03 |
5.9e+03 |
9.5e+04 |
2.4e+07 |
1.6e+12 |
12 |
3.0e+03 |
1.2e+04 |
1.9e+05 |
4.8e+07 |
3.2e+12 |
13 |
5.9e+03 |
2.4e+04 |
3.8e+05 |
9.7e+07 |
6.3e+12 |
14 |
1.2e+04 |
4.7e+04 |
7.6e+05 |
1.9e+08 |
1.3e+13 |
15 |
2.4e+04 |
9.5e+04 |
1.5e+06 |
3.9e+08 |
2.5e+13 |
Parameter description: Specifies the default threshold for switching from the explicit mode to the sparse mode.
Type: USERSET
Value range: an integer ranging from –1 to 7 –1 indicates the auto mode; 0 indicates that the explicit mode is skipped; a value from 1 to 7 indicates that the mode is switched when the number of distinct values reaches 2hll_default_expthresh.
Default value: –1
Parameter description: Specifies whether to enable the sparse mode by default.
Type: USERSET
Valid value: 0 and 1 0 indicates that the sparse mode is disabled by default. 1 indicates that the sparse mode is enabled by default.
Default value: 1
Parameter description: Specifies the size of max_sparse.
Type: USERSET
Value range: an integer ranging from –1 to INT_MAX
Default value: –1
Parameter description: Specifies whether to enable memory optimization for HLL.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies the number of buckets in the HyperLogLog++ (HLL++) algorithm. This parameter can be used to adjust the error rate of the approx_count_distinct aggregate function. The number of buckets affects the precision of estimating the distinct value. Having more buckets increases the accuracy of the estimation. The deviation range is as follows: [–1.04/2log2m*1/2, +1.04/2log2m*1/2]
Type: USERSET
Value range: an integer ranging from 10 to 20.
Default value: 17
Parameter description: Controls the maximum physical memory that can be used when each CN or DN executes UDFs.
Type: POSTMASTER
Value range: an integer ranging from 200 x 1024 to the value of max_process_memory and the unit is KB.
Default value: 0.05 * max_process_memory
Parameter description: Controls the virtual memory used by each fenced udf worker process.
Type: USERSET
Suggestion: You are not advised to set this parameter. You can set udf_memory_limit instead.
Value range: an integer. The unit can be KB, MB, or GB. 0 indicates that the memory is not limited.
Default value: 0
Parameter description: Specifies whether the optimizer optimizes the query plan for statements executed in Parse Bind Execute (PBE) mode.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether the optimizer optimizes the execution of simple queries on CNs.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Controls whether multiple CNs can concurrently perform DDL operations on the same database object.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies whether to enable the logic for verifying the number of rows in a result set in the collaborative analysis. This parameter is supported only by clusters of version 8.1.3.310 or later.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: When the GaussDB(DWS) cluster is accelerated (acceleration_with_compute_pool is set to on), specifies whether the EXPLAIN statement displays the evaluation information about execution plan pushdown to computing Node Groups. The evaluation information is generally used by O&M personnel during maintenance, and it may affect the output display of the EXPLAIN statement. Therefore, this parameter is disabled by default. The evaluation information is displayed only if the verbose option of the EXPLAIN statement is enabled.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Used in conjunction with disable_full_group_by_mysql in behavior_compat_options to control two different behaviors when disable_full_group_by_mysql syntax is enabled.
Type: USERSET
Value range: a string
Default value: notpadding
This parameter only takes effect when disable_full_group_by_mysql is enabled in the MySQL-compatible library and non-aggregate columns are present in the query. The two behaviors of this parameter only apply to non-aggregate columns in the query.
Parameter description: Specifies whether to use the cudesc streaming path for accessing data across logical clusters in the decoupled storage and compute architecture. This parameter is supported only by clusters of version 9.1.0 or later.
Type: SUSET
Default value: on
Parameter description: Forces data to be read from other logical clusters in the decoupled storage and compute architecture (i.e., read data from the logical cluster where the table resides). This parameter is supported only by clusters of version 9.0.0 or later.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies the timeout interval for KV synchronization in the decoupled storage and compute architecture. This parameter is supported only by clusters of version 9.0.0 or later.
Type: USERSET
Value range: an integer ranging from 0 to 2147483647
Default value: 10min
Parameter description: Specifies whether to enable DOP acceleration when data is written into an OBS foreign table. The number of DOP threads on each DN is determined by query_dop. By adjusting its value, you can control the level of parallelism for your queries. This parameter is supported only in 9.1.0.200 and later versions.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies whether to enable partition redistribution optimization after insert dop is enabled for a foreign table. If the number of partitions to be exported is greater than 10 times the number of partitions, you are advised to enable this function to reduce small files in a single partition and improve export performance. This parameter is supported only in 9.1.0.200 and later versions.
Type: USERSET
Value range: Boolean
Default value: off
Parameter description: Specifies whether binlog tables can be created.
Type: SIGHUP
Value range: Boolean
Default value: off
Parameter description: Specifies whether binlogs are generated for DML operations on binlog tables in the current session. This parameter is supported only by clusters of version 9.1.0.200 or later.
Type: USERSET
Value range: Boolean
Default value: on
Parameter description: Specifies the duration for cyclically determining whether all binlog records are consumed during binlog table scaling or VACUUM FULL operations. This parameter is supported only by 8.3.0.100 and later versions. The unit is second.
Type: SIGHUP
Value range: an integer ranging from 0 to 86400
Default value: 3600