Todos os produtos
Search
Central de documentação

PolarDB:Compute layer parameter reference for PolarDB-X

Última atualização: Oct 13, 2026

Este tópico descreve os parâmetros da camada de computação do PolarDB-X.

Nota

Apenas as instâncias do PolarDB-X Enterprise Edition oferecem suporte aos parâmetros da camada de computação.

Parâmetro

Reinicialização necessária

Valor padrão

Faixa de valores

Descrição

PLAN_CACHE

Não

FALSE

[TRUE|FALSE]

Ative o cache de planos.

ENABLE_RECYCLEBIN

Não

FALSE

[TRUE|FALSE]

Ative a lixeira.

SHOW_TABLES_CACHE

Não

FALSE

[TRUE|FALSE]

Armazena em cache o resultado de SHOW TABLES.

MERGE_CONCURRENT

Não

FALSE

[TRUE|FALSE]

Controla a execução paralela completa. Afeta principalmente o paralelismo de instruções DDL e consultas simples totalmente delegadas (pushed-down).

MERGE_UNION

Não

FALSE

[TRUE|FALSE]

Desativado por padrão. Quando ativado, as instruções SQL físicas não realizam otimização de UNION e as instruções SQL físicas delegadas são executadas serialmente.

MERGE_UNION_SIZE

Não

-1

[0-10000]

Número de instruções SQL físicas mescladas por UNION. O padrão é adaptativo, com base nas conexões disponíveis no pool de conexões.

TABLE_META_CACHE_EXPIRE_TIME

Não

300

[0-180000]

Tempo de expiração do cache de metadados.

COLUMN_LABEL_INSENSITIVE

Não

TRUE

[FALSE|TRUE]

Defina se os nomes das colunas nos resultados da consulta diferenciam maiúsculas de minúsculas.

RECORD_SQL

Não

TRUE

[FALSE|TRUE]

Ative o log de auditoria.

SOCKET_TIMEOUT

Não

900000

[0~3600000]

Tempo limite para instruções SQL físicas.

TRANSACTION_POLICY

Não

TSO

[XA|TSO|TSO_READONLY]

Política de transação.

SHARE_READ_VIEW

Não

FALSE

[TRUE|FALSE]

Ative o ReadView compartilhado.

ENABLE_TRX_SINGLE_SHARD_OPTIMIZATION

Não

TRUE

[TRUE|FALSE]

Ative a otimização de transações em shard único.

GET_TSO_TIMEOUT

Não

10

[1-1800]

Tempo limite para obtenção de timestamps TSO.

MAX_TRX_DURATION

Não

28800

[1-180000]

Tempo limite físico para transações.

TRANSACTION_ISOLATION

Não

REPEATABLE-READ

[READ-UNCOMMITTED|READ-COMMITTED|REPEATABLE-READ|SERIALIZABLE]

Nível de isolamento da transação.

GROUP_CONCURRENT_BLOCK

Não

TRUE

[TRUE|FALSE]

Política de execução no nível do banco de dados em modo não MPP.

SEQUENTIAL_CONCURRENT_POLICY

Não

FALSE

[TRUE|FALSE]

Política de execução de concorrência única em modo não MPP.

DML_SKIP_DUPLICATE_CHECK_FOR_PK

Não

TRUE

[TRUE|FALSE]

Ignora verificações de conflito de chave primária durante operações DML.

DML_SKIP_CRUCIAL_ERR_CHECK

Não

FALSE

[TRUE|FALSE]

Permite que transações com erros DML continuem o commit.

DML_USE_RETURNING

Não

TRUE

[TRUE|FALSE]

Ative a otimização RETURNING.

BROADCAST_DML

Não

FALSE

[TRUE|FALSE]

Permite gravações em tabelas de broadcast sem transações distribuídas.

SEQUENCE_STEP

Não

10000

[1-10000000]

Incremento da SEQUENCE. O padrão é 100000.

MERGE_DDL_TIMEOUT

Não

0

[1-10000000]

Tempo limite para conexões físicas DDL. O padrão é 0, indicando ausência de tempo limite.

MERGE_DDL_CONCURRENT

Não

FALSE

[FALSE|TRUE]

Defina se instruções DDL usam modo paralelo completo. A concorrência padrão ocorre no nível do banco de dados.

SLOW_SQL_TIME

Não

1000

[1-180000]

Limiar para SQL lento.

LOAD_DATA_BATCH_INSERT_SIZE

Não

1024

[1-180000]

Número de registros por inserção em lote no LOAD DATA.

LOAD_DATA_CACHE_BUFFER_SIZE

Não

60

[1-180000]

Tamanho do cache do LOAD DATA. O padrão é 60 MB, utilizado principalmente para controle de fluxo.

MAX_ALLOWED_PACKET

Não

16777216

[4194304-33554432]

Tamanho máximo do pacote.

KILL_CLOSE_STREAM

Não

FALSE

[FALSE|TRUE]

Ative o encerramento antecipado de stream para conexões físicas.

ALLOW_SIMPLE_SEQUENCE

Não

FALSE

[FALSE|TRUE]

Permite o uso de sequências simples.

MAX_PARAMETERIZED_SQL_LOG_LENGTH

Não

5000

[1-1000000]

Comprimento máximo de SQL parametrizado para registro em log.

FORBID_EXECUTE_DML_ALL

Não

TRUE

[TRUE|FALSE]

Proíbe exclusão ou atualização de tabela inteira.

GROUP_SEQ_CHECK_INTERVAL

Sim

60

[1-36000]

Intervalo para verificação de inserção de valor explícito, em segundos.

JOIN_BLOCK_SIZE

Sim

300

[1-100000]

Quantidade de valores IN durante a execução de BKAJOIN sem poda dinâmica.

LOOKUP_JOIN_MAX_BATCH_SIZE

Sim

6400

[1-100000]

Número máximo de valores IN durante a execução de BKAJOIN.

LOOKUP_JOIN_MIN_BATCH_SIZE

Sim

100

[1-100000]

Número mínimo de valores IN durante a execução de BKAJOIN.

PURGE_TRANS_INTERVAL

Sim

300

[1-180000]

Intervalo de limpeza de logs de transação.

PURGE_TRANS_BEFORE

Sim

1800

[1-180000]

Idade dos logs de transação a serem limpos.

ENABLE_BACKGROUND_STATISTIC_COLLECTION

Não

TRUE

[TRUE|FALSE]

Ative a coleta de dados estatísticos.

GENERAL_DYNAMIC_SPEED_LIMITATION

Não

-1

[-1-10000000]

Limite de taxa para preenchimento e verificação de dados. -1 é o limite padrão, equivalente a 10.000 linhas por segundo.

PARALLELISM

Não

-1

[1-1024]

Paralelismo para execução paralela em nó único. O valor padrão deriva das especificações da instância.

LOGICAL_DB_TIME_ZONE

Não

SYSTEM

[SYSTEM|±HH:mm]

Fuso horário do banco de dados.

MPP_PARALLELISM

Não

-1

[1-1024]

Concorrência para o modo de execução MPP. O valor padrão deriva das especificações da instância.

DATABASE_PARALLELISM

Não

0

[0-1024]

Número de instruções SQL delegadas simultaneamente a um único DN por consulta, usado para calcular a concorrência de varredura.

POLARDBX_PARALLELISM

Não

0

[0-1024]

Concorrência máxima por consulta em um único CN. O padrão corresponde ao número de núcleos de CPU.

MPP_METRIC_LEVEL

Não

3

[0|1|2|3]

Nível de coleta de estatísticas durante a computação. Um nível mais alto indica granularidade mais fina.

ENABLE_COMPLEX_DML_CROSS_DB

Não

TRUE

[TRUE|FALSE]

Oferece suporte a DML complexo entre bancos de dados.

PER_QUERY_MEMORY_LIMIT

Sim

-1

[-1-9223372036854775807]

Limite de tamanho do pool de memória no nível da consulta. O padrão é um terço do pool global de conexões.

ENABLE_SPILL

Não

FALSE

[FALSE|TRUE]

Persistência de tabelas temporárias em disco.

CONN_POOL_MIN_POOL_SIZE

Não

20

[0-60]

Número mínimo de conexões físicas ao banco de dados.

CONN_POOL_MAX_POOL_SIZE

Não

60

[1-1600]

Número máximo de conexões físicas ao banco de dados.

CONN_POOL_MAX_WAIT_THREAD_COUNT

Não

0

[-1-8192]

Número máximo de conexões pendentes por shard de banco de dados (Druid).

CONN_POOL_IDLE_TIMEOUT

Não

30

[1-60]

Tempo limite para conexões físicas ociosas.

CONN_POOL_BLOCK_TIMEOUT

Não

5000

[1000-60000]

Tempo máximo de espera para obter uma conexão do pool de conexões físicas.

CONN_POOL_XPROTO_MAX_POOLED_SESSION_PER_INST

Não

512

[1-8192]

Número máximo de sessões em cache por nó de armazenamento (protocolo privado).

XPROTO_MAX_DN_CONCURRENT

Não

500

[1-8192]

Número máximo de solicitações simultâneas por nó de armazenamento (protocolo privado). O valor padrão foi alterado para 2000 em 23 de outubro de 2023 para atender à maioria dos cenários de produção e testes de estresse.

XPROTO_MAX_DN_WAIT_CONNECTION

Não

32

[1-8192]

Número máximo de solicitações pendentes por nó de armazenamento (protocolo privado). O valor padrão foi alterado para 2000 em 13 de junho de 2024 para atender à maioria dos cenários de produção e testes de estresse.

MERGE_SORT_BUFFER_SIZE

Não

2048

[1024-81920]

Tamanho do cache usado para merge sort na camada TableScan. O padrão é 2 MB.

WORKLOAD_TYPE

Não

[AP|TP]

Especifique a carga de trabalho da consulta. Por padrão, a carga é identificada inteligentemente com base no custo.

EXECUTOR_MODE

Não

[MPP|TP_LOCAL|AP_LOCAL]

Defina o modo de execução. Por padrão, o modo é selecionado conforme a carga de trabalho.

ENABLE_MASTER_MPP

Não

FALSE

[TRUE|FALSE]

Ative o MPP na instância primária.

LOOKUP_JOIN_BLOCK_SIZE_PER_SHARD

Sim

50

[1-100000]

Quantidade de valores IN por shard durante a execução de BKAJOIN com poda.

ENABLE_RUNTIME_FILTER

Não

TRUE

[TRUE|FALSE]

Ative o Runtime Filter.

FEEDBACK_WORKLOAD_AP_THRESHOLD

Não

FALSE

[TRUE|FALSE]

Chave HTAP FEEDBACK para consultas AP.

FEEDBACK_WORKLOAD_TP_THRESHOLD

Não

FALSE

[TRUE|FALSE]

Chave HTAP FEEDBACK para consultas TP.

MASTER_READ_WEIGHT

Não

-1

[0-100]

O tráfego de consulta é roteado para DNs somente leitura na proporção de (100-MASTER_READ_WEIGHT).

SHOW_ALL_PARAMS

Não

FALSE

[TRUE|FALSE]

Exibe todas as variáveis SHOW.

FORCE_READ_OUTSIDE_TX

Não

FALSE

[TRUE|FALSE]

Força múltiplas conexões em um único shard de banco de dados dentro de uma transação.

ENABLE_COROUTINE

Sim

FALSE

[TRUE|FALSE]

Ative corrotinas wisp.

TRUNCATE_TABLE_WITH_GSI

Não

FALSE

[TRUE|FALSE]

Permite TRUNCATE em tabelas com GSI.

DDL_ON_GSI

Não

FALSE

[TRUE|FALSE]

Permite operações DDL diretamente em tabelas GSI.

DML_ON_GSI

Não

FALSE

[TRUE|FALSE]

Permite operações DML diretamente em tabelas GSI.

ENABLE_HASH_JOIN

Não

TRUE

[TRUE|FALSE]

Permite a geração de nós HashJoin durante a otimização de consultas.

ENABLE_BKA_JOIN

Não

TRUE

[TRUE|FALSE]

Permite a geração de nós BKAJoin durante a otimização de consultas.

ENABLE_NL_JOIN

Não

TRUE

[TRUE|FALSE]

Permite a geração de nós NLJoin durante a otimização de consultas.

ENABLE_SEMI_NL_JOIN

Não

TRUE

[TRUE|FALSE]

Permite converter SemiJoin para NLJoin durante a otimização de consultas.

ENABLE_SEMI_HASH_JOIN

Não

TRUE

[TRUE|FALSE]

Permite converter SemiJoin para HashJoin durante a otimização de consultas.

ENABLE_SEMI_BKA_JOIN

Não

TRUE

[TRUE|FALSE]

Permite converter SemiJoin para BKAJoin durante a otimização de consultas.

ENABLE_SEMI_SORT_MERGE_JOIN

Não

TRUE

[TRUE|FALSE]

Permite converter SemiJoin para MergeJoin durante a otimização de consultas.

ENABLE_MATERIALIZED_SEMI_JOIN

Não

Não

[TRUE|FALSE]

Permite converter SemiJoin para MaterializedJoin durante a otimização de consultas.

ENABLE_SEMI_JOIN_REORDER

Não

TRUE

[TRUE|FALSE]

Permite que o SemiJoin participe da otimização de reordenação CBO durante a otimização de consultas.

ENABLE_HASH_AGG

Não

TRUE

[TRUE|FALSE]

Permite a geração de nós HashAgg durante a otimização de consultas.

ENABLE_PARTIAL_AGG

Não

TRUE

[TRUE|FALSE]

Permite dividir a agregação em duas fases durante a otimização de consultas.

ENABLE_SORT_AGG

Não

TRUE

[TRUE|FALSE]

Permite a geração de nós SortAgg durante a otimização de consultas.

ENABLE_PUSH_PROJECT

Não

TRUE

[TRUE|FALSE]

Permite delegação de projeção durante a otimização de consultas.

ENABLE_PUSH_JOIN

Não

TRUE

[TRUE|FALSE]

Permite delegação de junção durante a otimização de consultas.

ENABLE_PUSH_AGG

Não

TRUE

[TRUE|FALSE]

Permite delegação de agregação durante a otimização de consultas.

ENABLE_CBO_PUSH_AGG

Não

TRUE

[TRUE|FALSE]

Permite passagem direta de agregação para junções durante a otimização de consultas.

ENABLE_PUSH_SORT

Não

TRUE

[TRUE|FALSE]

Permite delegação de ordenação durante a otimização de consultas.

ENABLE_STATISTIC_FEEDBACK

Não

TRUE

[TRUE|FALSE]

Oferece suporte à correção de estatísticas baseada em Feedback.

ENABLE_CBO_PUSH_JOIN

Não

TRUE

[TRUE|FALSE]

Permite otimização de passagem direta de junção durante a otimização de consultas.

ENABLE_SORT_JOIN_TRANSPOSE

Não

TRUE

[TRUE|FALSE]

Permite passagem direta de ordenação para junções durante a otimização de consultas.

CHUNK_SIZE

Não

1024

[1-10240]

Tamanho do lote para cada computação do executor.

ENABLE_SORT_MERGE_JOIN

Não

TRUE

[TRUE|FALSE]

Defina se a geração de nós MergeJoin deve ser proibida durante a otimização de consultas.

ENABLE_BKA_PRUNING

Não

TRUE

[TRUE|FALSE]

Ative a poda de BKAJoin.

ENABLE_SPM

Não

TRUE

[TRUE|FALSE]

Ative o gerenciamento de planos de execução.

ENABLE_EXPRESSION_VECTORIZATION

Não

TRUE

[TRUE|FALSE]

Ative a avaliação vetorizada de expressões.

FORCE_DDL_ON_LEGACY_ENGINE

Não

TRUE

[TRUE|FALSE]

Ative o novo DDL engine.

PURE_ASYNC_DDL_MODE

Não

FALSE

[TRUE|FALSE]

Execute tarefas DDL de forma não bloqueante. Quando ativado, o cliente retorna imediatamente após executar o DDL, e você pode executar SHOW [FULL] DDL para verificar o status da execução.

DDL_JOB_REQUEST_TIMEOUT

Não

90000

[1-9223372036854775807]

Tempo limite máximo para execução de DDL. O padrão é 25 dias.

LOGICAL_DDL_PARALLELISM

Não

1

[1-10240]

Concorrência para execução lógica de DDL. Definir como 1 significa execução serial de DDL.

ENABLE_BROADCAST_RANDOM_READ

Não

TRUE

[TRUE|FALSE]

Ative a otimização de leitura aleatória para tabelas de broadcast.

STORAGE_DELAY_THRESHOLD

Não

16777216s

[0-16777216]

Grau de conscientização do CN sobre a latência do DN durante consultas. Se a latência exceder o limiar, o tráfego somente leitura roteado para DNs somente leitura será tratado com base no parâmetro DELAY_EXECUTION_STRATEGY.

DELAY_EXECUTION_STRATEGY

Não

CONTINUE_TO_SLAVE

[CONTINUE_TO_SLAVE | CHANGE_TO_MASTER | THROW_EXCEPTION]

Quando a latência do DN somente leitura excede o limiar, três valores podem ser definidos:

  • CONTINUE_TO_SLAVE: O tráfego somente leitura roteado para DNs somente leitura pode continuar sendo roteado para o DN somente leitura cuja latência excede o limiar.

  • CHANGE_TO_MASTER: O tráfego somente leitura é roteado preferencialmente para DNs somente leitura com latência normal. Se todos os DNs somente leitura excederem o limiar de latência, o tráfego será roteado para o DN da instância primária.

  • THROW_EXCEPTION: Se todos os DNs somente leitura excederem o limiar de latência, as consultas roteadas para DNs somente leitura retornarão erros.

STORAGE_BUSY_THRESHOLD

Não

100

[0-16777216]

Quando existem múltiplos DNs somente leitura, se o número de threads ativas em um DN somente leitura exceder o limiar, o DN é considerado ocupado e o tráfego somente leitura é desviado dele. Se todos os DNs somente leitura estiverem ocupados, o tráfego somente leitura será roteado aleatoriamente para um deles.

ENABLE_CONSISTENT_REPLICA_READ

Não

TRUE

[TRUE|FALSE]

Chave para requisitos de leitura consistente.

TRUE: O tráfego roteado para DNs somente leitura pode atender aos requisitos de leitura consistente e ler os dados confirmados mais recentes.

FALSE: A atualidade dos dados do tráfego roteado para DNs somente leitura depende da latência de sincronização entre as instâncias primária e secundária.

SUPPORT_INSTANT_ADD_COLUMN

Não

OFF

[ON|OFF]

Chave para o recurso Instant Add Column. Ative-o usando a instrução SET GLOBAL.

ENABLE_STATEMENTS_SUMMARY

Não

true

[true|false]

Chave para agregação de SQL.

STATEMENTS_SUMMARY_PERCENT

Não

1

[0-100]

Porcentagem de agregação de SQL.