Compute layer parameters for PolarDB-X - PolarDB: Central de Documentação do Alibaba Cloud

Grupos de parâmetros

Geral
Execução de consultas e paralelismo
Opções do otimizador
Transação
Comportamento de DML
Comportamento de DDL
Pool de conexões
Separação de leitura e escrita
Monitoramento e logs
LOAD DATA

Geral

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`PLAN_CACHE`	Não	FALSE	TRUE	FALSE	—	Ative ou desative o cache de planos.
`ENABLE_RECYCLEBIN`	Não	FALSE	TRUE	FALSE	—	Ative ou desative a lixeira.
`SHOW_TABLES_CACHE`	Não	FALSE	TRUE	FALSE	—	Controla o armazenamento em cache dos resultados de instruções `SHOW TABLES`.
`TABLE_META_CACHE_EXPIRE_TIME`	Não	300	0–180000	Segundos	Tempo de vida (TTL) do cache de metadados.
`COLUMN_LABEL_INSENSITIVE`	Não	TRUE	TRUE	FALSE	—	Controla a diferenciação entre maiúsculas e minúsculas nos rótulos de colunas retornados.
`MAX_ALLOWED_PACKET`	Não	16777216	4194304–33554432	Bytes	Tamanho máximo do pacote.
`CHUNK_SIZE`	Não	1024	1–10240	Linhas	Tamanho do lote do executor. O executor processa dados em lotes desse tamanho.
`LOGICAL_DB_TIME_ZONE`	Não	SYSTEM	SYSTEM	±HH:mm	—	Fuso horário do banco de dados.
`SHOW_ALL_PARAMS`	Não	FALSE	TRUE	FALSE	—	Controla se `SHOW VARIABLES` exibe todos os parâmetros.
`ENABLE_SPILL`	Não	FALSE	TRUE	FALSE	—	Ative ou desative o despejo de tabelas temporárias para o disco.
`PER_QUERY_MEMORY_LIMIT`	Sim	-1	-1–9223372036854775807	Bytes	Limite de memória para o pool no nível de consulta. O valor padrão (-1) corresponde a um terço do tamanho global do pool de conexões.
`ENABLE_COROUTINE`	Sim	FALSE	TRUE	FALSE	—	Ative ou desative a corrotina Wisp.
`SUPPORT_INSTANT_ADD_COLUMN`	Não	OFF	ON	OFF	—	Ative ou desative a adição instantânea de coluna. Defina este parâmetro com `SET GLOBAL`.
`ENABLE_STATEMENTS_SUMMARY`	Não	true	true	false	—	Ative ou desative a agregação de instruções SQL.
`STATEMENTS_SUMMARY_PERCENT`	Não	1	0–100	Porcentagem	Percentual de instruções SQL a agregar.

Execução de consultas e paralelismo

Paralelismo

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`PARALLELISM`	Não	-1	1–1024	Threads	Grau de paralelismo (DOP) para um único nó. O valor padrão (-1) indica que o sistema defina esse valor conforme as especificações do nó.
`MPP_PARALLELISM`	Não	-1	1–1024	Threads	DOP para o modo de execução de processamento massivamente paralelo (MPP). O valor padrão (-1) indica que o sistema defina esse valor conforme as especificações do nó.
`DATABASE_PARALLELISM`	Não	0	0–1024	—	Número de instruções SQL enviadas simultaneamente por uma única consulta a um nó de dados (DN). Esse valor calcula o DOP em operações de varredura.
`POLARDBX_PARALLELISM`	Não	0	0–1024	Threads	DOP máximo para uma única consulta em um nó de computação (CN). O valor padrão (0) equivale ao número de núcleos de CPU.
`MPP_METRIC_LEVEL`	Não	3	0	1	2	3	—	Nível de detalhe na coleta de estatísticas de desempenho durante a computação. Valores mais altos indicam maior granularidade.
`LOGICAL_DDL_PARALLELISM`	Não	1	1–10240	—	DOP para execução de DDL lógico. O valor padrão (1) indica execução sequencial das tarefas DDL.

Modo de execução

WORKLOAD_TYPE e EXECUTOR_MODE determinam como o PolarDB-X classifica e executa consultas.

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`WORKLOAD_TYPE`	Não	(auto)	AP	TP	—	Tipo de carga de trabalho da consulta. Se omitido, o sistema identifica automaticamente o tipo com base no custo. Defina como `AP` para forçar processamento analítico; defina como `TP` para forçar processamento transacional.
`EXECUTOR_MODE`	Não	(auto)	MPP	TP_LOCAL	AP_LOCAL	—	Modo de execução da consulta. Se omitido, o sistema seleciona um modo conforme o tipo de carga de trabalho. `MPP` habilita execução distribuída entre nós; `TP_LOCAL` e `AP_LOCAL` restringem a execução ao nó de computação local.
`ENABLE_MASTER_MPP`	Não	FALSE	TRUE	FALSE	—	Controla a ativação do MPP na instância primária.

Controle de concorrência

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`MERGE_CONCURRENT`	Não	FALSE	TRUE	FALSE	—	Ative ou desative execução totalmente paralela. Afeta principalmente o DOP de instruções DDL e consultas simples com pushdown completo.
`MERGE_UNION`	Não	FALSE	TRUE	FALSE	—	Controla a otimização de `UNION` para instruções SQL físicas. Quando ativado, não realiza otimização de `UNION` e executa instruções SQL físicas com pushdown sequencialmente.
`MERGE_UNION_SIZE`	Não	-1	0–10000	—	Número de instruções SQL físicas a mesclar via `UNION`. O valor padrão (-1) indica definição automática pelo sistema conforme as conexões disponíveis no pool.
`GROUP_CONCURRENT_BLOCK`	Não	TRUE	TRUE	FALSE	—	Política de execução no nível de sharding do banco de dados fora do modo MPP.
`SEQUENTIAL_CONCURRENT_POLICY`	Não	FALSE	TRUE	FALSE	—	Política de execução sequencial para requisições concorrentes fora do modo MPP.
`MERGE_SORT_BUFFER_SIZE`	Não	2048	1024–81920	KB	Tamanho do buffer para operações de merge sort na camada TableScan. O valor padrão é 2 MB.

Tamanhos de lote para BKA join

Os parâmetros de junção Batched Key Access (BKA) definem quantos valores IN são agrupados por consulta, afetando desempenho e uso de memória.

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`JOIN_BLOCK_SIZE`	Sim	300	1–100000	Valores	Quantidade de valores `IN` para junção BKA com pruning dinâmico desativado.
`LOOKUP_JOIN_MAX_BATCH_SIZE`	Sim	6400	1–100000	Valores	Quantidade máxima de valores `IN` para junção BKA.
`LOOKUP_JOIN_MIN_BATCH_SIZE`	Sim	100	1–100000	Valores	Quantidade mínima de valores `IN` para junção BKA.
`LOOKUP_JOIN_BLOCK_SIZE_PER_SHARD`	Sim	50	1–100000	Valores	Quantidade de valores `IN` por shard para junção BKA com pruning ativado.

Opções do otimizador

Todos os parâmetros de opções do otimizador entram em vigor imediatamente, sem reinicialização.

Estratégias de junção

Parâmetro	Padrão	Descrição
`ENABLE_HASH_JOIN`	TRUE	Permite que o otimizador gere nós HashJoin durante a otimização do plano de consulta.
`ENABLE_BKA_JOIN`	TRUE	Permite que o otimizador gere nós BKAJoin durante a otimização do plano de consulta.
`ENABLE_NL_JOIN`	TRUE	Permite que o otimizador gere nós NLJoin (nested loop) durante a otimização do plano de consulta.
`ENABLE_SORT_MERGE_JOIN`	TRUE	Permite que o otimizador gere nós SortMergeJoin durante a otimização do plano de consulta.
`ENABLE_BKA_PRUNING`	TRUE	Ative ou desative pruning para junções BKA.

Conversão de SemiJoin

Parâmetro	Padrão	Descrição
`ENABLE_SEMI_NL_JOIN`	TRUE	Permite converter SemiJoin em NLJoin durante a otimização do plano de consulta.
`ENABLE_SEMI_HASH_JOIN`	TRUE	Permite converter SemiJoin em HashJoin durante a otimização do plano de consulta.
`ENABLE_SEMI_BKA_JOIN`	TRUE	Permite converter SemiJoin em BKAJoin durante a otimização do plano de consulta.
`ENABLE_SEMI_SORT_MERGE_JOIN`	TRUE	Permite converter SemiJoin em MergeJoin durante a otimização do plano de consulta.
`ENABLE_MATERIALIZED_SEMI_JOIN`	TRUE	Permite converter SemiJoin em MaterializedJoin durante a otimização do plano de consulta.
`ENABLE_SEMI_JOIN_REORDER`	TRUE	Permite incluir SemiJoin no reordenamento do otimizador baseado em custo (CBO).

Estratégias de agregação

Parâmetro	Padrão	Descrição
`ENABLE_HASH_AGG`	TRUE	Permite gerar nós HashAgg.
`ENABLE_PARTIAL_AGG`	TRUE	Permite dividir uma agregação em dois estágios.
`ENABLE_SORT_AGG`	TRUE	Permite gerar nós SortAgg.

Otimizações de pushdown

Parâmetro	Padrão	Descrição
`ENABLE_PUSH_PROJECT`	TRUE	Permite pushdown de Project.
`ENABLE_PUSH_JOIN`	TRUE	Permite pushdown de Join.
`ENABLE_PUSH_AGG`	TRUE	Permite pushdown de Aggregation.
`ENABLE_CBO_PUSH_AGG`	TRUE	Permite mover uma agregação através de uma junção.
`ENABLE_PUSH_SORT`	TRUE	Permite pushdown de Sort.
`ENABLE_CBO_PUSH_JOIN`	TRUE	Permite otimização de passagem direta de junção (join pass-through).
`ENABLE_SORT_JOIN_TRANSPOSE`	TRUE	Permite mover uma ordenação através de uma junção.

Estatísticas e gerenciamento de planos

Parâmetro	Padrão	Descrição
`ENABLE_STATISTIC_FEEDBACK`	TRUE	Ative correção de estatísticas baseada em feedback.
`ENABLE_BACKGROUND_STATISTIC_COLLECTION`	TRUE	Ative coleta de estatísticas em segundo plano.
`ENABLE_RUNTIME_FILTER`	TRUE	Ative ou desative filtro de tempo de execução.
`ENABLE_EXPRESSION_VECTORIZATION`	TRUE	Ative ou desative vetorização de expressões.
`ENABLE_SPM`	TRUE	Especifica se o gerenciamento de planos de execução (SPM) está ativado.

Feedback de carga de trabalho HTAP

Parâmetro	Padrão	Descrição
`FEEDBACK_WORKLOAD_AP_THRESHOLD`	FALSE	Ative ou desative feedback HTAP para consultas de processamento analítico (AP).
`FEEDBACK_WORKLOAD_TP_THRESHOLD`	FALSE	Ative ou desative feedback HTAP para consultas de processamento transacional (TP).

Transação

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`TRANSACTION_POLICY`	Não	TSO	XA	TSO	TSO_READONLY	—	Política de transação. Consulte Escolhendo uma política de transação.
`TRANSACTION_ISOLATION`	Não	REPEATABLE-READ	READ-UNCOMMITTED	READ-COMMITTED	REPEATABLE-READ	SERIALIZABLE	—	Nível de isolamento da transação.
`SHARE_READ_VIEW`	Não	FALSE	TRUE	FALSE	—	Ative ou desative ReadView compartilhado.
`ENABLE_TRX_SINGLE_SHARD_OPTIMIZATION`	Não	TRUE	TRUE	FALSE	—	Ative ou desative otimização de shard único para transações.
`GET_TSO_TIMEOUT`	Não	10	1–1800	Segundos	Tempo limite para obter timestamp do Timestamp Oracle (TSO).
`MAX_TRX_DURATION`	Não	28800	1–180000	Segundos	Tempo limite físico para transação.
`PURGE_TRANS_INTERVAL`	Sim	300	1–180000	Segundos	Intervalo para purga de logs de transação.
`PURGE_TRANS_BEFORE`	Sim	1800	1–180000	Segundos	Idade dos logs de transação a purgar. O sistema remove logs anteriores a esse valor.
`FORCE_READ_OUTSIDE_TX`	Não	FALSE	TRUE	FALSE	—	Força abertura de múltiplas conexões para um único shard dentro de uma transação.

Escolhendo uma política de transação

TRANSACTION_POLICY aceita três valores:

TSO (padrão): Usa Timestamp Oracle para ordenar transações distribuídas. Recomendado para a maioria das cargas de produção, pois oferece leituras consistentes com menor sobrecarga que XA.
XA: Utiliza protocolo de commit em duas fases XA. Use quando for necessária compatibilidade estrita com transações externas.
TSO_READONLY: Semelhante ao TSO, mas restringe a sessão a transações somente leitura.

Comportamento de DML

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`DML_SKIP_DUPLICATE_CHECK_FOR_PK`	Não	TRUE	TRUE	FALSE	—	Ignora verificação de conflito de chave primária durante execução de DML.
`DML_SKIP_CRUCIAL_ERR_CHECK`	Não	FALSE	TRUE	FALSE	—	Permite confirmar (commit) transações com erros de DML.
`DML_USE_RETURNING`	Não	TRUE	TRUE	FALSE	—	Usa cláusula `RETURNING` para otimização.
`BROADCAST_DML`	Não	FALSE	TRUE	FALSE	—	Permite que gravações em tabelas de broadcast contornem transações distribuídas.
`FORBID_EXECUTE_DML_ALL`	Não	TRUE	TRUE	FALSE	—	Proíbe operações `DELETE` e `UPDATE` em tabela completa.
`ENABLE_COMPLEX_DML_CROSS_DB`	Não	TRUE	TRUE	FALSE	—	Suporta instruções DML complexas entre bancos de dados.
`SEQUENCE_STEP`	Não	10000	1–10000000	—	Incremento da sequência. O valor padrão é 100.000.
`ALLOW_SIMPLE_SEQUENCE`	Não	FALSE	TRUE	FALSE	—	Permite uso de sequências simples.
`GENERAL_DYNAMIC_SPEED_LIMITATION`	Não	-1	-1–10000000	Linhas/s	Limite dinâmico de velocidade para backfill e validação de dados. O valor padrão (-1) estabelece limite de 10.000 linhas por segundo.
`TRUNCATE_TABLE_WITH_GSI`	Não	FALSE	TRUE	FALSE	—	Permite `TRUNCATE TABLE` em tabelas com índice secundário global (GSI).
`DML_ON_GSI`	Não	FALSE	TRUE	FALSE	—	Permite executar instruções DML diretamente em tabelas GSI.

Comportamento de DDL

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`MERGE_DDL_TIMEOUT`	Não	0	1–10000000	—	Tempo limite para conexão DDL física. O valor padrão (0) indica ausência de tempo limite.
`MERGE_DDL_CONCURRENT`	Não	FALSE	TRUE	FALSE	—	Executa instruções DDL em modo totalmente paralelo. Por padrão, a execução ocorre com concorrência no nível do banco de dados.
`DDL_ON_GSI`	Não	FALSE	TRUE	FALSE	—	Permite executar instruções DDL diretamente em tabelas GSI.
`FORCE_DDL_ON_LEGACY_ENGINE`	Não	TRUE	TRUE	FALSE	—	Especifica se o novo mecanismo DDL está ativado.
`PURE_ASYNC_DDL_MODE`	Não	FALSE	TRUE	FALSE	—	Executa tarefas DDL em modo não bloqueante (assíncrono). Quando ativado, o cliente retorna imediatamente após enviar a instrução DDL. Verifique o status com `SHOW [FULL] DDL`.
`DDL_JOB_REQUEST_TIMEOUT`	Não	90000	1–9223372036854775807	—	Tempo limite máximo para job DDL. O valor padrão é 25 dias.
`GROUP_SEQ_CHECK_INTERVAL`	Sim	60	1–36000	Segundos	Intervalo para verificar valores inseridos explicitamente.
`ENABLE_BROADCAST_RANDOM_READ`	Não	TRUE	TRUE	FALSE	—	Ative ou desative otimização de leitura aleatória para tabelas de broadcast.

Pool de conexões

Parâmetros com prefixo CONN_POOL_ aplicam-se ao pool de conexões padrão (JDBC). Parâmetros com prefixo XPROTO_ aplicam-se ao pool de conexões de protocolo proprietário.

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`CONN_POOL_MIN_POOL_SIZE`	Não	20	0–60	Conexões	Mínimo de conexões para um shard físico do banco de dados.
`CONN_POOL_MAX_POOL_SIZE`	Não	60	1–1600	Conexões	Máximo de conexões para um shard físico do banco de dados.
`CONN_POOL_MAX_WAIT_THREAD_COUNT`	Não	0	-1–8192	Threads	Máximo de threads aguardando conexão para um único shard. Aplica-se ao pool Druid.
`CONN_POOL_IDLE_TIMEOUT`	Não	30	1–60	Segundos	Tempo limite para conexão física ociosa.
`CONN_POOL_BLOCK_TIMEOUT`	Não	5000	1000–60000	Milissegundos	Tempo máximo de espera por conexão no pool físico.
`CONN_POOL_XPROTO_MAX_POOLED_SESSION_PER_INST`	Não	512	1–8192	Sessões	Máximo de sessões em cache por nó de armazenamento (apenas protocolo proprietário).
`SOCKET_TIMEOUT`	Não	900000	0–3600000	Milissegundos	Tempo limite de conexão para instruções SQL físicas.
`XPROTO_MAX_DN_CONCURRENT`	Não	500	1–8192	Requisições	Máximo de requisições simultâneas por nó de armazenamento (apenas protocolo proprietário). O padrão foi atualizado para 2000 em 23 de outubro de 2023 para atender à maioria das cargas de produção e testes de estresse.
`XPROTO_MAX_DN_WAIT_CONNECTION`	Não	32	1–8192	Requisições	Máximo de requisições em espera por nó de armazenamento (apenas protocolo proprietário). O padrão foi atualizado para 2000 em 13 de junho de 2024 para atender à maioria das cargas de produção e testes de estresse.
`KILL_CLOSE_STREAM`	Não	FALSE	TRUE	FALSE	—	Ative ou desative encerramento antecipado de streams de conexão física.

Separação de leitura e escrita

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`MASTER_READ_WEIGHT`	Não	-1	0–100	Porcentagem	Determina distribuição do tráfego de leitura. A porcentagem roteada para DNs somente leitura é `(100 - MASTER_READ_WEIGHT)`. O restante vai para DNs da instância primária.
`STORAGE_DELAY_THRESHOLD`	Não	16777216	0–16777216	—	Limiar de latência de sincronização para DN conforme percebido pelo CN. Se a latência de um DN somente leitura exceder esse limiar, o tráfego segue a `DELAY_EXECUTION_STRATEGY`.
`DELAY_EXECUTION_STRATEGY`	Não	CONTINUE_TO_SLAVE	CONTINUE_TO_SLAVE	CHANGE_TO_MASTER	THROW_EXCEPTION	—	Política aplicada quando DN somente leitura excede o `STORAGE_DELAY_THRESHOLD`. Consulte Escolhendo uma estratégia de execução atrasada.
`STORAGE_BUSY_THRESHOLD`	Não	100	0–16777216	Threads	Limiar de threads ativas para DN somente leitura. Se a contagem exceder esse valor, o roteador evita enviar tráfego de leitura. Se todos os DNs somente leitura estiverem ocupados, o tráfego retorna para um DN somente leitura aleatório.
`ENABLE_CONSISTENT_REPLICA_READ`	Não	TRUE	TRUE	FALSE	—	Ative ou desative leituras consistentes de réplicas. Quando TRUE, leituras de DNs somente leitura atendem aos requisitos de consistência e retornam dados confirmados mais recentes. Quando FALSE, a atualização depende da latência de replicação.

Escolhendo uma estratégia de execução atrasada

DELAY_EXECUTION_STRATEGY aceita três valores:

CONTINUE_TO_SLAVE (padrão): Roteia tráfego de leitura para o DN somente leitura mesmo com latência acima do limiar. Use quando disponibilidade for prioritária sobre atualização de dados.
CHANGE_TO_MASTER: Roteia tráfego para DN somente leitura saudável. Se todos excederem o limiar, o tráfego retorna para DNs da instância primária. Use para obter dados atualizados evitando erros.
THROW_EXCEPTION: Gera falha em consultas roteadas para DNs somente leitura quando todos excedem o limiar. Use quando a aplicação não tolerar dados desatualizados e exigir falha explícita.

Monitoramento e logs

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`RECORD_SQL`	Não	TRUE	TRUE	FALSE	—	Ative ou desative log de auditoria.
`SLOW_SQL_TIME`	Não	1000	1–180000	Milissegundos	Limiar para instrução SQL lenta.
`MAX_PARAMETERIZED_SQL_LOG_LENGTH`	Não	5000	1–1000000	Caracteres	Comprimento máximo de instrução SQL parametrizada impressa no log.
`MPP_METRIC_LEVEL`	Não	3	0	1	2	3	—	Nível de detalhe na coleta de estatísticas de desempenho durante computação. Valores mais altos indicam maior granularidade.

LOAD DATA

Parâmetro	Restart required	Padrão	Intervalo	Unidade	Descrição
`LOAD_DATA_BATCH_INSERT_SIZE`	Não	1024	1–180000	Linhas	Registros por lote de inserção em instrução `LOAD DATA`.
`LOAD_DATA_CACHE_BUFFER_SIZE`	Não	60	1–180000	MB	Buffer de cache para instruções `LOAD DATA`. Valor padrão: 60 MB. Usado principalmente para limitação de taxa (throttling).