Todos os produtos
Search
Central de documentação

AnalyticDB:Parâmetros de configuração e hints

Última atualização: Aug 27, 2026

AnalyticDB for MySQL permite configurar parâmetros por meio do comando SET (sintaxe: SET ADB_CONFIG KEY=VALUE) e hints (sintaxe: /*+ KEY=VALUE*/). O comando SET ADB_CONFIG modifica configurações globais que entram em vigor em todo o cluster. Um hint aplica-se apenas à instrução SQL especificada e não afeta as configurações globais. Caso tanto SET ADB_CONFIG quanto um hint sejam usados para configurar o mesmo parâmetro, o hint terá precedência. Este tópico descreve os parâmetros de configuração comuns no AnalyticDB for MySQL.

Parâmetros de configuração comuns

Quando a versão do kernel do cluster é 3.2.5 ou posterior, o sistema valida os tipos dos parâmetros de configuração.

Nota

Visualize e atualize a versão do kernel na página Cluster Information do console AnalyticDB for MySQL, na seção Configuration Information.

Categoria

Parâmetro

Descrição

Exemplo

Referências

Janela de switchover

REPLICATION_SWITCH_TIME_RANGE

Descrição Durante um switchover de cluster, o cluster antigo suporta apenas operações de leitura por 5 a 10 minutos. Após conectar-se ao cluster antigo, configure REPLICATION_SWITCH_TIME_RANGE para especificar a janela de tempo para alternar entre os clusters antigo e novo. Se você não configurar uma janela de tempo de switchover, a alternância automática entre os clusters ocorrerá assim que todos os dados incrementais do cluster antigo forem sincronizados em tempo real com o novo cluster. SET ADB_CONFIG REPLICATION_SWITCH_TIME_RANGE=`23:00, 23:30`;

Scale a Data Warehouse Edition cluster and change the cluster mode

Limites da condição IN

MAX_IN_ITEMS_COUNT

Descrição Define o número máximo de itens em uma condição IN. Valores válidos: inteiros positivos maiores que 0. Para clusters com versões de kernel anteriores à 3.2.8, o valor padrão é 4000. Em clusters com versão de kernel 3.2.8 ou posterior, o valor padrão é 20000.

SET ADB_CONFIG MAX_IN_ITEMS_COUNT=4000;

Writes and queries

Máximo de colunas SELECT

MAX_SELECT_ITEMS_COUNT

Descrição Número máximo de colunas em uma instrução SELECT. Valor padrão: 1024. Aumentar esse valor pode afetar a estabilidade do cluster. Não recomendamos alterar este valor. SET ADB_CONFIG MAX_SELECT_ITEMS_COUNT=1000; Referência

Timeout de consulta

QUERY_TIMEOUT

Descrição Período de timeout para execução de consultas. Valor padrão: 1800000 ms (30 minutos). Este parâmetro controla apenas o timeout de execução de instruções SQL, sem afetar o timeout de conexão ou o timeout de ociosidade da sessão. SET ADB_CONFIG QUERY_TIMEOUT=1000;

Otimização de consulta/Política de runtime

DYNAMIC_FILTER_WAIT_TIME_IN_MS

Descrição Limiar de tempo de espera para filtragem dinâmica. Este parâmetro controla a duração da espera para construir filtros dinâmicos em operações de join, equilibrando o desempenho da consulta e o consumo de recursos. SHOW ADB_CONFIG KEY=DYNAMIC_FILTER_WAIT_TIME_IN_MS;

Timeout de INSERT, UPDATE, DELETE

INSERT_SELECT_TIMEOUT

Descrição Tempo máximo de execução para instruções INSERT, UPDATE e DELETE no nível do cluster. Valor padrão: 24*3600000. Valores válidos: inteiros maiores que 0. Unidade: milissegundos. SET ADB_CONFIG INSERT_SELECT_TIMEOUT=3600000; Referência

Limits

Desativação de pushdown de predicado

Parâmetros Versão do kernel 3.1.4 ou posterior: FILTER_NOT_PUSHDOWN_COLUMNS Versões do kernel anteriores à 3.1.4: NO_INDEX_COLUMNS Descrição Desativa o pushdown de predicado para colunas específicas no nível do cluster.

Desative o pushdown de predicado para colunas específicas no nível do cluster.

  • Versão do kernel 3.1.4 ou posterior: SET ADB_CONFIG FILTER_NOT_PUSHDOWN_COLUMNS=[Schema1.tableName1:colName1|colName2;Schema2.tableName2:colName1|colName2]

  • Versões do kernel anteriores à 3.1.4: SET ADB_CONFIG NO_INDEX_COLUMNS=[tableName1.colName1;colName2,tableName2.colName1]

Filter conditions without pushdown

Modo de execução de consulta

QUERY_TYPE

Descrição Alterna o modo de execução de consulta da instância. Valores válidos: interactive batch Clusters Cluster Edition em modo reservado e clusters Data Lake Edition não suportam a alteração do modo de execução de consulta.

SET ADB_CONFIG QUERY_TYPE=interactive;

Query execution modes

Concorrência da fila de consultas

XIHE_ENV_QUERY_ETL_MAX_CONCURRENT_SIZE

Número máximo de consultas executadas simultaneamente na fila LOWEST em um único nó frontend. Valor padrão: 20.

SET ADB_CONFIG XIHE_ENV_QUERY_ETL_MAX_CONCURRENT_SIZE=20;

Priority queues and concurrency of interactive resource groups

XIHE_ENV_QUERY_ETL_MAX_QUEUED_SIZE

Número máximo de consultas enfileiradas na fila LOWEST em um único nó frontend. Valor padrão: 200.

SET ADB_CONFIG XIHE_ENV_QUERY_ETL_MAX_QUEUED_SIZE=200;

XIHE_ENV_QUERY_LOW_PRIORITY_MAX_CONCURRENT_SIZE

Número máximo de consultas executadas simultaneamente na fila LOW em um único nó frontend. Valor padrão: 20.

SET ADB_CONFIG XIHE_ENV_QUERY_LOW_PRIORITY_MAX_CONCURRENT_SIZE=20;

XIHE_ENV_QUERY_LOW_PRIORITY_MAX_QUEUED_SIZE

Número máximo de consultas enfileiradas na fila LOW em um único nó frontend. Valor padrão: 200.

SET ADB_CONFIG XIHE_ENV_QUERY_LOW_PRIORITY_MAX_QUEUED_SIZE=200;

XIHE_ENV_QUERY_NORMAL_MAX_CONCURRENT_SIZE

Número máximo de consultas executadas simultaneamente na fila NORMAL em um único nó frontend. Valor padrão: 20. Quando o limite é excedido, novas consultas são enfileiradas. Se a fila estiver cheia, o sistema retorna um erro "Too many queued queries". Aumente este valor ou crie grupos de recursos personalizados para distribuir a carga.

SET ADB_CONFIG XIHE_ENV_QUERY_NORMAL_MAX_CONCURRENT_SIZE=20;

XIHE_ENV_QUERY_NORMAL_MAX_QUEUED_SIZE

Número máximo de consultas enfileiradas na fila NORMAL em um único nó frontend. Valor padrão: 200.

SET ADB_CONFIG XIHE_ENV_QUERY_NORMAL_MAX_QUEUED_SIZE=200;

XIHE_ENV_QUERY_HIGH_MAX_CONCURRENT_SIZE

Número máximo de consultas executadas simultaneamente na fila HIGH em um único nó frontend. Valor padrão: 40.

SET ADB_CONFIG XIHE_ENV_QUERY_HIGH_MAX_CONCURRENT_SIZE=40;

XIHE_ENV_QUERY_HIGH_MAX_QUEUED_SIZE

Número máximo de consultas enfileiradas na fila HIGH em um único nó frontend. Valor padrão: 400.

SET ADB_CONFIG XIHE_ENV_QUERY_HIGH_MAX_QUEUED_SIZE=400;

Prioridade de job BSP do XIHE

QUERY_PRIORITY

Prioridade dos jobs BSP. Valores válidos:

  • HIGH

  • NORMAL (padrão)

  • LOW

  • LOWEST

SET ADB_CONFIG QUERY_PRIORITY=HIGH;

XIHE BSP SQL development

Configurações máximas de ACU usadas por job BSP do XIHE

ELASTIC_JOB_MAX_ACU

Número máximo de ACUs que um único job BSP do XIHE pode usar. Valor padrão: 9. Valor mínimo: 3. Valores válidos: [3, recursos máximos do grupo de recursos do tipo job].

SET ADB_CONFIG ELASTIC_JOB_MAX_ACU=20;

Timeout de consulta para jobs BSP do XIHE

BATCH_QUERY_TIMEOUT

Período de timeout para jobs BSP do XIHE. Valor padrão: 7200000 ms. Valores válidos: inteiros maiores que 0. Unidade: milissegundos.

SET ADB_CONFIG BATCH_QUERY_TIMEOUT=3600000 ;

Importação de tabela externa: OSS

HIVE_SPLIT_ASYNC_GENERATION_ENABLED

Descrição Especifica se as tarefas Hive Split devem ser enviadas assincronamente para uma fila quando o Hive gera um plano de execução. Valores válidos: true: Sim. false (padrão): Não.

SET ADB_CONFIG HIVE_SPLIT_ASYNC_GENERATION_ENABLED=true;

Nenhuma

Importação de tabela externa: MaxCompute

SQL_OUTPUT_BATCH_SIZE

Número de linhas por lote durante a importação de dados. Valores válidos: inteiros maiores que 0.

SET ADB_CONFIG SQL_OUTPUT_BATCH_SIZE = 6000;

Import and export

ENABLE_ODPS_MULTI_PARTITION_PART_MATCH

Especifica se o sistema deve pré-percorrer e recuperar o número de registros em cada partição do MaxCompute.

SET ADB_CONFIG ENABLE_ODPS_MULTI_PARTITION_PART_MATCH=false;

ASYNC_GET_SPLIT

Especifica se as tarefas devem ser enviadas assincronamente para uma fila otimizando o desempenho de carregamento de Split quando o MaxCompute gera um plano de execução. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

Nota Este parâmetro é suportado apenas na versão do kernel 3.1.10.1 e posteriores.

SET ADB_CONFIG ASYNC_GET_SPLIT=true;

Agendamento automático de BUILD

RC_CSTORE_BUILD_SCHEDULE_PERIOD

Descrição Restringe o período de tempo para agendamento de tarefas BUILD. Isso não restringe o período de execução da tarefa BUILD. Valores válidos: inteiros de 0 a 24. SET ADB_CONFIG RC_CSTORE_BUILD_SCHEDULE_PERIOD=`6,8`; Referência

BUILD

Prioridade de agendamento BUILD

Descrição Permite configurar a prioridade de agendamento BUILD para uma ou mais tabelas. A prioridade permanece efetiva até que você a reconfigure. O parâmetro task_priority controla a prioridade de agendamento BUILD. Valores válidos: inteiros. Valor padrão: 0.

Configure a prioridade de agendamento BUILD para uma única tabela ou múltiplas tabelas. A prioridade permanece efetiva até que você a reconfigure.

O parâmetro task_priority controla a prioridade de agendamento BUILD. Valores válidos: inteiros. Valor padrão: 0.

SET ADB_CONFIG RC_BUILD_TASK_PRIORITY_LIST = `<db1_name>.<table1_name>.<task_priority>;<db2_name>.<table2_name>.<task_priority>`;

BUILD

Importação elástica

RC_ELASTIC_JOB_SCHEDULER_ENABLE

Ative manualmente a opção de importação elástica para utilizar esse recurso.

SET ADB_CONFIG RC_ELASTIC_JOB_SCHEDULER_ENABLE=true; Referência

Função REMOTE_CALL

XIHE_REMOTE_CALL_SERVER_ENDPOINT

O endpoint interno do Function Compute para chamar remotamente funções personalizadas no Function Compute através da função REMOTE_CALL. Para mais informações, consulte Service endpoints.

SET ADB_CONFIG XIHE_REMOTE_CALL_SERVER_ENDPOINT="1234567890000****.cn-zhangjiakou-internal.fc.aliyuncs.com"

UDFs

XIHE_REMOTE_CALL_SERVER_AK

AccessKey ID da conta Alibaba Cloud ou usuário RAM proprietário do service Function Compute ao usar a função REMOTE_CALL para invocar funções personalizadas remotamente.

SET ADB_CONFIG XIHE_REMOTE_CALL_SERVER_AK=**;

XIHE_REMOTE_CALL_SERVER_SK

AccessKey Secret da conta Alibaba Cloud ou usuário RAM proprietário do service Function Compute ao usar a função REMOTE_CALL para invocar funções personalizadas remotamente.

SET ADB_CONFIG XIHE_REMOTE_CALL_SERVER_SK=**;

XIHE_REMOTE_CALL_COMPRESS_ENABLED

Especifica se a compressão GZIP deve ser usada para compactar dados antes de enviá-los ao Function Compute ao usar a função REMOTE_CALL para invocar funções personalizadas remotamente.

SET ADB_CONFIG REMOTE_CALL_COMPRESS_ENABLED=true;

XIHE_REMOTE_CALL_MAX_BATCH_SIZE

Número de linhas de dados enviadas ao Function Compute ao usar a função REMOTE_CALL para invocar funções personalizadas remotamente.

SET ADB_CONFIG XIHE_REMOTE_CALL_MAX_BATCH_SIZE=500000;

Controle de concorrência de scan

  • true (padrão): Ativa o controle de concorrência de scan.

  • false: Desativa o controle de concorrência de scan.

AnalyticDB for MySQL permite configurar a cota de concorrência de scan para evitar instabilidade nos nós causada por concorrência excessiva que consome muitos recursos. Valores válidos:

  • true (Valor padrão): Ativar controle de concorrência de scan.

  • false: Desativar controle de concorrência de scan.

SET ADB_CONFIG SPLIT_FLOW_CONTROL_ENABLED=true;

Split flow control

AnalyticDB for MySQL suporta ajuste dinâmico da cota de concorrência de scan das tarefas com base na cota geral de concorrência de scan de cada nó. Valores válidos:

  • true: Ativa o ajuste dinâmico do controle de concorrência de scan de tarefas.

  • false (padrão): Desativa o ajuste dinâmico do controle de concorrência de scan de tarefas.

AnalyticDB for MySQL suporta ajuste dinâmico da cota de concorrência de scan das tarefas com base na cota geral de concorrência de scan de cada nó. Valores válidos:

  • true: Ativar ajuste dinâmico do controle de concorrência de scan de tarefas.

  • false (Valor padrão): Desativar ajuste dinâmico do controle de concorrência de scan de tarefas.

SET ADB_CONFIG NODE_LEVEL_SPLIT_FLOW_CONTROL_ENABLED=true;

MIN_RUNNING_SPLITS_LIMIT_PER_TASK

Cota mínima de concorrência de scan por tarefa. Valor padrão: 1. Valores válidos: [1, TARGET_RUNNING_SPLITS_LIMIT_PER_TASK].

SET ADB_CONFIG MIN_RUNNING_SPLITS_LIMIT_PER_TASK=24;

TARGET_RUNNING_SPLITS_LIMIT_PER_TASK

Cota alvo (ponto médio) de concorrência de scan por tarefa. O sistema aumenta ou diminui a cota de concorrência de scan com base neste valor. Valor padrão: 32. Valores válidos: [MIN_RUNNING_SPLITS_LIMIT_PER_TASK, MAX_RUNNING_SPLITS_LIMIT_PER_TASK].

TARGET_RUNNING_SPLITS_LIMIT_PER_TASK=32;

MAX_RUNNING_SPLITS_LIMIT_PER_TASK

Cota máxima de concorrência de scan por tarefa. Valor padrão: 64. Valores válidos: maior que TARGET_RUNNING_SPLITS_LIMIT_PER_TASK.

SET ADB_CONFIG MAX_RUNNING_SPLITS_LIMIT_PER_TASK=128;

A cota padrão de concorrência de scan para nós de armazenamento é 256. Um valor excessivamente alto ou baixo pode afetar o desempenho do cluster. Recomendamos não alterar o valor padrão.

A cota padrão de concorrência de scan para nós de armazenamento é 256. Um valor muito grande ou muito pequeno pode afetar o desempenho do cluster. Recomendamos não alterar o valor padrão.

SET ADB_CONFIG WORKER_MAX_RUNNING_SOURCE_SPLITS_PER_NODE=256;

A cota padrão de concorrência de scan para nós de computação é 256. Um valor excessivamente alto ou baixo pode afetar o desempenho do cluster. Recomendamos não alterar o valor padrão.

A cota padrão de concorrência de scan para nós de computação é 256. Um valor muito grande ou muito pequeno pode afetar o desempenho do cluster. Recomendamos não alterar o valor padrão.

SET ADB_CONFIG EXECUTOR_MAX_RUNNING_SOURCE_SPLITS_PER_NODE=256;

Sensibilidade a maiúsculas/minúsculas em view lógica

VIEW_OUTPUT_NAME_CASE_SENSITIVE

Descrição Especifica se os nomes de views lógicas diferenciam maiúsculas de minúsculas. Valores válidos: true: Diferencia maiúsculas de minúsculas. false (padrão): Não diferencia maiúsculas de minúsculas.

SET ADB_CONFIG VIEW_OUTPUT_NAME_CASE_SENSITIVE=true;

CREATE VIEW

Descrição Ativa manualmente o recurso Multi-Statement para executar múltiplas instruções SQL em sequência. Valores válidos: true: Ativado. false (padrão): Desativado.

ALLOW_MULTI_QUERIES

Ative manualmente o recurso Multi-Statement para executar múltiplas instruções SQL em sequência. Valores válidos:

  • true: Ativar.

  • false (Valor padrão): Desativar.

SET ADB_CONFIG ALLOW_MULTI_QUERIES=true;

Multi-statement

Ativar binary logging

BINLOG_ENABLE

Descrição Para clusters com versões de kernel anteriores à 3.2.0.0, ative manualmente o recurso Binlog antes de habilitar o Binlog para tabelas. Em clusters com versão de kernel 3.2.0.0 ou posterior, o recurso Binlog vem ativado por padrão. Não é necessário configurar este parâmetro. SET ADB_CONFIG BINLOG_ENABLE=true;

Refresh materialized views

Banco de dados usado para armazenar tabelas de cache temporárias para consultas de paginação. Se não especificado, o banco de dados interno da conexão atual será usado.

PAGING_CACHE_SCHEMA

Especifique o banco de dados para armazenar tabelas de cache de paginação temporárias. Se não especificado, o banco de dados interno da conexão atual será usado.

SET ADB_CONFIG PAGING_CACHE_SCHEMA=paging_cache;

Paging cache (performance optimization for deep paged queries)

PAGING_CACHE_MAX_TABLE_COUNT

Número máximo de tabelas de cache temporárias. A criação de novos caches falha quando esse limite é excedido. Valor padrão: 100. Valores válidos: inteiros maiores que 0.

SET ADB_CONFIG PAGING_CACHE_MAX_TABLE_COUNT=100;

PAGING_CACHE_EXPIRATION_TIME

Limiar de tempo de expiração do cache. Caches que não foram acessados dentro do período especificado são limpos automaticamente. Valor padrão: 600. Valores válidos: inteiros maiores que 0. Unidade: segundos.

SET ADB_CONFIG PAGING_CACHE_EXPIRATION_TIME=600;

PAGING_CACHE_ENABLE

Especifica se o recurso Paging Cache deve ser desativado globalmente. Valores válidos:

  • true (padrão): Ativado.

  • false: Desativado.

SET ADB_CONFIG PAGING_CACHE_ENABLE=false;

Especificar o mecanismo de tabela

RC_DDL_ENGINE_REWRITE_XUANWUV2

Descrição Especifica o mecanismo de tabela no nível do cluster. Valores válidos: true (padrão): Tabelas existentes mantêm seu mecanismo atual. Novas tabelas usam XUANWU_V2 por padrão. Mesmo que você especifique explicitamente ENGINE=XUANWU ao criar uma tabela, o mecanismo será alterado automaticamente para XUANWU_V2. false: Tabelas existentes mantêm seu mecanismo atual. Novas tabelas usam XUANWU por padrão.

SET ADB_CONFIG RC_DDL_ENGINE_REWRITE_XUANWUV2=true;

Configure the table engine

Hints comuns

Categoria

Parâmetro

Descrição

Exemplo

Referências

Timeout de consulta

QUERY_TIMEOUT

Descrição Período de timeout para execução de consultas. Valor padrão: 1800000 ms (30 minutos). Este parâmetro controla apenas o timeout de execução de instruções SQL, sem afetar o timeout de conexão ou o timeout de ociosidade da sessão. SET ADB_CONFIG QUERY_TIMEOUT=1000;

Writes and queries

Timeout de INSERT, UPDATE, DELETE

INSERT_SELECT_TIMEOUT

Descrição Tempo máximo de execução para instruções INSERT, UPDATE e DELETE no nível do cluster. Valor padrão: 24*3600000. Valores válidos: inteiros maiores que 0. Unidade: milissegundos. SET ADB_CONFIG INSERT_SELECT_TIMEOUT=3600000; Referência

Limits

Desativação de pushdown de predicado

Parâmetros Versão do kernel 3.1.4 ou posterior: FILTER_NOT_PUSHDOWN_COLUMNS Versões do kernel anteriores à 3.1.4: NO_INDEX_COLUMNS Descrição Desativa o pushdown de predicado para colunas específicas no nível do cluster.

Desative o pushdown de predicado para colunas específicas no nível da consulta.

  • Versão do kernel 3.1.4 ou posterior: /+ FILTER_NOT_PUSHDOWN_COLUMNS=[Schema1.table1:colName1|colName2;Schema2.table2:colName1|colName2] /

  • Versões do kernel anteriores à 3.1.4: /+ NO_INDEX_COLUMNS=[tableName1.colName1;colName2,tableName2.colName1] /

Filter conditions without pushdown

Prioridade de agendamento BUILD

BUILD_TASK_PRIORITY

Modifica a prioridade de agendamento da tarefa BUILD. Atualmente, use apenas hints para configurar a prioridade de agendamento BUILD para tabelas individuais. Valor padrão: 0. Valores válidos: inteiros maiores ou iguais a 0. Um valor maior indica uma prioridade mais alta.

/+ BUILD_TASK_PRIORITY = 2/ BUILD TABLE db.table;

Set scheduling priorities

Importação elástica

Ativa a importação elástica e configura o grupo de recursos do tipo job para executar tarefas de importação elástica.

Selecione Elastic Import e configure o grupo de recursos de job para tarefas de importação elástica.

/+ ELASTIC_LOAD=true, ELASTIC_LOAD_CONFIGS=[adb.load.resource.group.name=resource_group]/

SUBMIT JOB INSERT OVERWRITE INTO adb_demo.adb_import_test SELECT * FROM adb_external_db.person;

A implementação Hash Join usa a tabela direita para construção. O Left Join não reordena as tabelas esquerda e direita. Quando a tabela direita contém uma grande quantidade de dados, isso pode causar execução lenta e consumo excessivo de memória. Adicione um hint para instruir o otimizador a converter Left Join em Right Join com base no consumo de recursos. Valores válidos:

  • true: Ativado.

  • false (padrão): Desativado.

  • Versão do kernel 3.1.8 ou posterior: O_CBO_RULE_SWAP_OUTER_JOIN

  • Versões do kernel anteriores à 3.1.8: LEFT_TO_RIGHT_ENABLED

A implementação Hash Join usa a tabela direita para construção. O Left Join não reordena as tabelas esquerda e direita. Quando a tabela direita é grande, isso pode causar execução lenta e consumo excessivo de memória. Adicione um hint para instruir o otimizador a converter Left Join em Right Join com base no uso de recursos. Valores válidos:

  • true: Ativar.

  • false (Valor padrão): Desativar.

  • /+ O_CBO_RULE_SWAP_OUTER_JOIN=true/

  • /+ LEFT_TO_RIGHT_ENABLED=true/

Change LEFT JOIN to RIGHT JOIN

REORDER_JOINS

AnalyticDB for MySQL ativa o reordenamento automático de joins por padrão. Ajuste manualmente a ordem dos joins com base nas características dos dados para que a consulta siga a ordem de junção especificada na instrução SQL. Valores válidos:

  • true (padrão): Ativa o reordenamento automático de joins.

  • false: Desativa o reordenamento automático de joins.

/+ REORDER_JOINS=false/

Manually adjust the join order

AGGREGATION_PATH_TYPE

Ao usar agregação em duas fases, um grande número de grupos na agregação group-by consome recursos computacionais significativos. Use este hint para ignorar a agregação local e executar a agregação final diretamente. Valores válidos:

  • single_agg: Ignora a agregação local.

  • auto (padrão): O otimizador determina automaticamente se deve ignorar a agregação local.

/+ AGGREGATION_PATH_TYPE=single_agg/

Grouping and aggregation query optimization

Cada tarefa de computação é dividida em múltiplas tarefas concorrentes para utilizar totalmente os recursos de computação. Use este hint para definir a concorrência. Valor padrão: 32. Valores válidos: inteiros maiores que 0.

HASH_PARTITION_COUNT

Cada tarefa de computação é dividida em múltiplas tarefas concorrentes para aproveitar ao máximo os recursos de computação. Use este hint para definir a concorrência. Valor padrão: 32. Valores válidos: inteiros positivos.

/+ HASH_PARTITION_COUNT=32/

Nenhuma

BATCH_HASH_PARTITION_COUNT

Valor padrão: 32. Valores válidos: inteiros maiores que 0.

Importante

No modo batch (query_execution_type=batch), definir este valor muito alto pode causar um número excessivo de tarefas concorrentes em um nó, levando ao estouro do pool de memória. Quando o cluster possui mais de 32 nós de computação, recomendamos definir este parâmetro como o número de nós de computação para evitar problemas de limite de disco.

/+ BATCH_HASH_PARTITION_COUNT=64, QUERY_EXECUTION_TYPE=batch / SELECT ...

TASK_WRITER_COUNT

Concorrência das tarefas de importação INSERT INTO SELECT. Quando a carga do worker estiver muito alta, reduza este valor. Valor padrão: 16. Valores válidos: inteiros maiores que 0.

/+ TASK_WRITER_COUNT=8/

CTE_EXECUTION_MODE

Especifica se a otimização de execução CTE deve ser ativada. Quando ativada, uma subconsulta CTE referenciada várias vezes é executada apenas uma vez, melhorando o desempenho da consulta. Valores válidos:

  • shared: Ativa a otimização de execução CTE.

  • inline (padrão): Desativa a otimização de execução CTE.

/+ CTE_EXECUTION_MODE=shared/

WITH

Limites de condição de consulta

QUERY_MAX_SHUFFLE_DATA_SIZE_MB

Tamanho máximo de dados Shuffle para uma consulta. Por padrão, nenhum erro é acionado independentemente do volume de dados. Se este parâmetro for definido, o sistema encerra a consulta e reporta um erro quando o volume de dados excede o limiar. Valores válidos: inteiros maiores que 0. Unidade: MB.

/+ QUERY_MAX_SHUFFLE_DATA_SIZE_MB=1024/

Nenhuma

MAX_SELECT_ITEMS_COUNT

Descrição Número máximo de colunas em uma instrução SELECT. Valor padrão: 1024. Aumentar esse valor pode afetar a estabilidade do cluster. Não recomendamos alterar este valor. SET ADB_CONFIG MAX_SELECT_ITEMS_COUNT=1000; Referência

MAX_IN_ITEMS_COUNT

Descrição Define o número máximo de itens em uma condição IN. Valores válidos: inteiros positivos maiores que 0. Para clusters com versões de kernel anteriores à 3.2.8, o valor padrão é 4000. Em clusters com versão de kernel 3.2.8 ou posterior, o valor padrão é 20000.

/+ MAX_IN_ITEMS_COUNT=1000/

MAX_WHERE_ITEMS_COUNT

Define o número máximo de itens em uma cláusula WHERE. Valor padrão: 256. Valores válidos: inteiros maiores que 0.

/+ MAX_WHERE_ITEMS_COUNT=512/

Prioridade de job BSP do XIHE

QUERY_PRIORITY

Prioridade dos jobs BSP. Valores válidos:

  • HIGH

  • NORMAL (padrão)

  • LOW

  • LOWEST

/+ QUERY_PRIORITY=HIGH/

XIHE BSP SQL development

Configurações máximas de ACU usadas por job BSP do XIHE

ELASTIC_JOB_MAX_ACU

Número máximo de ACUs que um único job BSP do XIHE pode usar. Valor padrão: 9. Valor mínimo: 3. Valores válidos: [3, recursos máximos do grupo de recursos do tipo job].

/+ ELASTIC_JOB_MAX_ACU=20/

Timeout de consulta para jobs BSP do XIHE

BATCH_QUERY_TIMEOUT

Período de timeout para jobs BSP do XIHE. Valor padrão: 7200000 ms. Valores válidos: inteiros maiores que 0. Unidade: milissegundos.

/+ BATCH_QUERY_TIMEOUT=3600000/

Tabelas externas OSS

OUTPUT_FILENAME

Personaliza o nome do arquivo armazenado no OSS ao exportar dados através de tabelas externas OSS.

/+ OUTPUT_FILENAME=output.csv/

Export data to OSS

SQL_OUTPUT_OSS_FILE_HEAD_ENABLE

Especifica se os nomes das colunas devem ser incluídos nos arquivos de dados exportados no OSS. Por padrão, os arquivos exportados contêm apenas dados, sem nomes de colunas. Valores válidos:

  • true: Incluir nomes de colunas.

  • false (padrão): Não incluir nomes de colunas.

/+ SQL_OUTPUT_OSS_FILE_HEAD_ENABLE=true/

HIVE_SPLIT_ASYNC_GENERATION_ENABLED

Descrição Especifica se as tarefas Hive Split devem ser enviadas assincronamente para uma fila quando o Hive gera um plano de execução. Valores válidos: true: Sim. false (padrão): Não.

/+ HIVE_SPLIT_ASYNC_GENERATION_ENABLED=true/

Import OSS data using external tables

FAST_PARQUET_READER_ENABLE

Especifica se o sistema deve retornar ao leitor nativo de Parquet quando as estatísticas em um arquivo Parquet estiverem incorretas. Valores válidos:

  • true (padrão): Sim.

  • false: Não.

/+ FAST_PARQUET_READER_ENABLE=true/

OSS_VECTORIZED_PARQUET_READER_ENABLE

Especifica se a opção de leitura vetorizada de Parquet deve ser ativada quando não existem valores NULL nos dados. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

/+ OSS_VECTORIZED_PARQUET_READER_ENABLE=true/

OSS_VECTORIZED_PARQUET_READER_NULL_SCENE_ENABLE

Especifica se a opção de leitura vetorizada de Parquet deve ser ativada quando existem valores NULL nos dados. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

/+ OSS_VECTORIZED_PARQUET_READER_NULL_SCENE_ENABLE=true/

Especifica se os metadados do Hudi devem ser carregados. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

Especifica se os metadados do Hudi devem ser carregados. Valores válidos:

  • true: Sim.

  • false (Valor padrão): Não.

/+ HUDI_METADATA_TABLE_ENABLED=true/

HUDI_QUERY_TYPE

Define o modo de consulta para tabelas Hudi. Valores válidos:

  • snapshot: Consulta todos os dados que foram confirmados (committed) ou compactados no momento especificado.

  • read_optimized (padrão): Consulta dados após o último commit ou compactação.

/+ HUDI_QUERY_TYPE=snapshot/

HUDI_REALTIME_SKIP_MERGE

Especifica se a mesclagem de arquivos base e arquivos de log deve ser ignorada ao consultar dados de tabela Hudi no modo snapshot. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

/+ HUDI_REALTIME_SKIP_MERGE=true/

Tamanho máximo do split. Valor padrão: 128. Unidade: MB.

Tamanho máximo do split. Valor padrão: 128. Unidade: MB.

/+ HUDI_MAX_SPLIT_SIZE=128/

HUDI_SPLIT_PARALLEL_GENERATION_ENABLED

Especifica se os splits devem ser gerados em paralelo. Valores válidos:

  • true (padrão): Sim.

  • false: Não.

/+ HUDI_SPLIT_PARALLEL_GENERATION_ENABLED=true/

HUDI_DATA_SKIPPING_ENABLED

Usa estatísticas da MetaTable do Hudi para ignorar splits que não precisam ser lidos, melhorando o desempenho da consulta. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

/+ HUDI_DATA_SKIPPING_ENABLED=true/

HUDI_SPLIT_ASYNC_GENERATION_ENABLED

Especifica se os splits do Hudi devem ser gerados assincronamente durante a geração do plano de execução. Valores válidos:

  • true (padrão): Sim.

  • false: Não.

/+ HUDI_SPLIT_ASYNC_GENERATION_ENABLED=true/

Tabelas externas RDS MySQL

JDBC_SCAN_SPLITS

Número de splits ao realizar um TableScan via JDBC. Valor padrão: 1. Valores válidos: 1 a 100.

/+ JDBC_SCAN_SPLITS=1/

Import RDS MySQL data by using an external table

JDBC_SPLIT_COLUMN

Coluna usada para dividir dados ao ler tabelas externas RDS MySQL.

/+ JDBC_SPLIT_COLUMN=column1/

JDBC_INSERT_DIRECTLY

Ao gravar dados em tabelas externas RDS MySQL, os dados são gravados primeiro em uma tabela temporária e depois na tabela de destino por padrão. Use este hint para gravar dados diretamente na tabela de destino. No entanto, se ocorrer algum erro durante a gravação, a tabela de destino poderá conter dados inconsistentes. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

/+ JDBC_INSERT_DIRECTLY=true/

Tabelas externas Tablestore

Especifica se instruções INSERT devem ser usadas em vez de instruções UPDATE. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

Especifica se instruções INSERT devem ser usadas em vez de instruções UPDATE. Valores válidos:

  • true: Sim.

  • false (Valor padrão): Não.

/+ OTS-INSERT-AS-UPDATE=true/

Query and import data from Tablestore

Tabelas externas MaxCompute

ODPS_SPLIT_LIMIT

Número máximo de splits ao ler dados via Tunnel. Valor padrão: 1000. Valores válidos: 1 a 1000.

/+ ODPS_SPLIT_LIMIT=1000/

Import MaxCompute data using external tables

IGNORE_PARTITION_CACHE

Ao executar consultas com condições de partição, recupera metadados de partição diretamente das tabelas MaxCompute em vez de usar metadados de partição em cache. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

/+ IGNORE_PARTITION_CACHE=true/

ROWS_PER_SPLIT

Número máximo de linhas por split ao ler dados via Tunnel. Valor padrão: 500000. Valores válidos: 10000 a 500000.

/+ ROWS_PER_SPLIT=500000/

STORAGE_API_ENABLED

Especifica se a Storage API do MaxCompute deve ser usada para ler dados do MaxCompute. A Storage API oferece desempenho de leitura significativamente superior ao Tunnel tradicional. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

/+ STORAGE_API_ENABLED=true/

APLIT_BYTE_SIZE

Tamanho máximo por split ao ler dados através da Storage API do MaxCompute. Valor padrão: 256. Unidade: MB.

/+ APLIT_BYTE_SIZE=256/

MAX_BATCH_ROW_COUNT

Número máximo de linhas por split ao ler dados através da Storage API do MaxCompute. Valor padrão: 1024.

/+ MAX_BATCH_ROW_COUNT=1024/

PAGE_BATCH_SIZE

Número máximo de linhas por página ao ler dados através da Storage API do MaxCompute. Valor padrão: 1024.

/+ PAGE_BATCH_SIZE=1024/

MAX_ALLOCATION_PER_SPLIT

Memória de pico máxima alocada por split ao ler dados através da Storage API do MaxCompute. Valor padrão: 300. Unidade: MB.

/+ MAX_ALLOCATION_PER_SPLIT=300/

ASYNC_GET_SPLIT

Especifica se as tarefas devem ser enviadas assincronamente para uma fila otimizando o desempenho de carregamento de Split quando o MaxCompute gera um plano de execução. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

Nota Este parâmetro é suportado apenas na versão do kernel 3.1.10.1 e posteriores.

/+ ASYNC_GET_SPLIT=true/

Controle de concorrência de scan

SPLIT_FLOW_CONTROL_ENABLED

  • true (padrão): Ativa o controle de concorrência de scan.

  • false: Desativa o controle de concorrência de scan.

/+ SPLIT_FLOW_CONTROL_ENABLED=true/ SELECT * FROM table;

Split flow control

MIN_RUNNING_SPLITS_LIMIT_PER_TASK

Cota mínima de concorrência de scan por tarefa. Valor padrão: 1. Valores válidos: [1, TARGET_RUNNING_SPLITS_LIMIT_PER_TASK].

/+ MIN_RUNNING_SPLITS_LIMIT_PER_TASK=10/SELECT * FROM orders;

TARGET_RUNNING_SPLITS_LIMIT_PER_TASK

Cota alvo (ponto médio) de concorrência de scan por tarefa. O sistema aumenta ou diminui a cota de concorrência de scan com base neste valor. Valor padrão: 32. Valores válidos: [MIN_RUNNING_SPLITS_LIMIT_PER_TASK, MAX_RUNNING_SPLITS_LIMIT_PER_TASK].

/+ TARGET_RUNNING_SPLITS_LIMIT_PER_TASK=32/SELECT * FROM adb_test;

MAX_RUNNING_SPLITS_LIMIT_PER_TASK

Cota máxima de concorrência de scan por tarefa. Valor padrão: 64. Valores válidos: maior que TARGET_RUNNING_SPLITS_LIMIT_PER_TASK.

/+ MAX_RUNNING_SPLITS_LIMIT_PER_TASK=100/SELECT * FROM adb_test;

Ativa o recurso Paging Cache e especifica manualmente um paging_id para identificar o cache de um grupo de consultas de paginação relacionadas (consultas com o mesmo padrão, mas diferentes parâmetros LIMIT e OFFSET).

PAGING_ID

Ative o recurso de cache de paginação e especifique manualmente um paging_id para identificar um grupo de consultas de paginação relacionadas (ou seja, um grupo de consultas com o mesmo padrão, mas diferentes valores de parâmetro LIMIT e OFFSET).

/PAGING_ID=paging123/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;

Paging cache (performance optimization for deep paged queries)

PAGING_CACHE_ENABLED

Ativa o recurso Paging Cache e gera automaticamente um paging_id com base no padrão SQL para identificar o cache de um grupo de consultas de paginação relacionadas. Valores válidos:

  • true: Ativa o recurso Paging Cache.

  • false (padrão): Desativa o recurso Paging Cache.

/PAGING_CACHE_ENABLED=true/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;

PAGING_CACHE_VALIDITY_INTERVAL

Define o período de validade do cache. Após esse período, o cache expira. Se o cache não for acessado dentro de uma hora após a expiração, o sistema exclui automaticamente a tabela de cache temporária correspondente. Valores válidos: inteiros maiores que 0. Unidade: segundos. Este parâmetro deve ser usado junto com paging_cache_enabled.

/PAGING_CACHE_ENABLED=true,PAGING_CACHE_VALIDITY_INTERVAL=300/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;

INVALIDATE_PAGING_CACHE

Especifica se o cache de consulta de paginação para um padrão especificado deve ser limpo. Valores válidos:

  • true: Sim.

  • false (padrão): Não.

Este parâmetro deve ser usado junto com paging_id ou paging_cache_enabled.

/PAGING_CACHE_ENABLED=true,INVALIDATE_PAGING_CACHE=true/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;

Especificar o mecanismo de tabela

RC_DDL_ENGINE_REWRITE_XUANWUV2

Descrição Especifica o mecanismo de tabela no nível do cluster. Valores válidos: true (padrão): Tabelas existentes mantêm seu mecanismo atual. Novas tabelas usam XUANWU_V2 por padrão. Mesmo que você especifique explicitamente ENGINE=XUANWU ao criar uma tabela, o mecanismo será alterado automaticamente para XUANWU_V2. false: Tabelas existentes mantêm seu mecanismo atual. Novas tabelas usam XUANWU por padrão.

/+ RC_DDL_ENGINE_REWRITE_XUANWUV2=true /

Configure the table engine

Outros

RESOURCE_GROUP

Especifica o grupo de recursos para uma consulta. Se não especificado, o grupo de recursos vinculado à conta do banco de dados será usado. Se nenhum grupo de recursos estiver vinculado à conta, o grupo de recursos padrão será utilizado.

/+ RESOURCE_GROUP=my_group_name/

Nenhuma

DML_EXCEPTION_TO_NULL_ENABLED

Especifica se uma exceção deve ser lançada quando valores inválidos forem encontrados durante operações INSERT SELECT. Valores válidos:

  • true: Não lança exceção. Grava valores NULL em vez disso.

  • false (padrão): Lança uma exceção.

/+ DML_EXCEPTION_TO_NULL_ENABLED=true/

DISPLAY_HINT

Usado para marcar consultas, por exemplo, para identificar consultas de diferentes origens de negócios.

/+ DISPLAY_HINT=from_user_123/

FAQ

Como remover um parâmetro de configuração?

Se você definiu um parâmetro de configuração usando SET ADB_CONFIG key=value; e deseja restaurar o parâmetro para o valor padrão, utilize o método a seguir.

Método

Exemplo

SET ADB_CONFIG REMOVE key;
SET ADB_CONFIG REMOVE QUERY_TIMEOUT; -- Restore the query timeout to the default value.

Após a execução do comando, execute SHOW ADB_CONFIG KEY=key; para verificar se o parâmetro foi restaurado para o valor padrão.