Todos os produtos
Search

Este produto

    PolarDB:Parâmetros

    Central de documentação

    PolarDB:Parâmetros

    Última atualização: Jul 16, 2026

    Este tópico descreve os parâmetros relacionados ao IMCI e os tipos de dados compatíveis.

    Parâmetros de configuração

    Parâmetro

    Valores válidos

    Valor padrão

    Descrição

    polar_csi.enable_query

    on|off

    off

    Defina se as consultas podem usar o IMCI. Valores válidos:

    • off (padrão): as consultas não usam o IMCI.

    • on: as consultas usam o IMCI.

    polar_csi.cost_threshold

    1~1000000000

    50000

    Se o custo da consulta for inferior a este limiar, a instrução SQL não usará o IMCI para aceleração. Ajuste o valor conforme sua carga de trabalho.

    • Valores muito altos impedem que instruções SQL demoradas usem o IMCI, resultando em consultas mais lentas.

    • Valores muito baixos fazem com que instruções SQL simples usem o IMCI, reduzindo a concorrência do sistema.

    Nota

    • Use EXPLAIN ou EXPLAIN ANALYZE para consultar e analisar o custo das instruções SQL.

    • PostgreSQL 14: na versão secundária do mecanismo 2.0.14.13.28.0 e posteriores, o valor padrão deste parâmetro mudou para 50000. Em versões anteriores, o valor padrão era 1000.

    • PostgreSQL 16: na versão secundária do mecanismo 2.0.16.10.12.0 e posteriores, o valor padrão deste parâmetro mudou para 50000. Em versões anteriores, o valor padrão era 1000.

    polar_csi.max_parallel_workers

    1~512

    2

    Grau de paralelismo do IMCI, ou seja, os recursos de CPU que uma única instrução SQL pode utilizar. Geralmente, maior paralelismo oferece melhor desempenho.

    O valor ideal depende das especificações de recursos do cluster. Ajuste-o conforme essas especificações. Recomendamos não definir um valor superior ao número de núcleos de CPU do nó de computação.

    Nota

    O parâmetro polar_csi.max_parallel_workers chamava-se polar_csi.exec_parallel em versões anteriores do kernel. Para versões do kernel sem suporte a polar_csi.max_parallel_workers, use polar_csi.exec_parallel.

    • PostgreSQL 14:

      • Use polar_csi.exec_parallel nas versões 2.0.14.20.42.0 e anteriores.

      • Use polar_csi.max_parallel_workers nas versões 2.0.14.20.43.0 e posteriores.

    • PostgreSQL 16:

      • Use polar_csi.exec_parallel nas versões 2.0.16.11.15.0 e anteriores.

      • Use polar_csi.max_parallel_workers nas versões 2.0.16.13.16.0 e posteriores.

    polar_csi.memory_limit

    1~1048576

    4096

    Quantidade de memória disponível para o IMCI. Unidade: MB.

    Um limite maior de memória acelera a criação de índices. Ajuste o valor conforme as especificações do cluster. Recomendamos não definir um valor superior a 25% da memória do cluster para evitar erros de falta de memória (OOM).

    Nota

    • PostgreSQL 14: na versão secundária do mecanismo 2.0.14.19.40.0 e posteriores, o valor padrão deste parâmetro mudou para 4096. Em versões anteriores, o valor padrão era 1024.

    • PostgreSQL 16: na versão secundária do mecanismo 2.0.16.10.12.0 e posteriores, o valor padrão deste parâmetro mudou para 4096. Em versões anteriores, o valor padrão era 1024.

    polar_csi.flush_count

    2048~20480000

    204800

    Número de linhas confirmadas (committed) em cada lote durante a criação do índice.

    Aumentar o número de linhas melhora a eficiência da criação, mas exige mais memória.

    polar_csi.update_interval

    0~3600

    1

    Intervalo de atualização periódica do desempenho em tempo real dos dados linha-coluna. Unidade: segundos.

    Aumentar o intervalo de atualização permite mesclar pequenas transações do mesmo tipo, melhorando a eficiência da atualização de dados em cenários com alto volume de transações.

    Nota

    • PostgreSQL 14: parâmetro adicionado na versão secundária do mecanismo 2.0.14.13.28.0 e posteriores para melhorar o desempenho em tempo real do IMCI.

    • PostgreSQL 16: parâmetro adicionado na versão secundária do mecanismo 2.0.16.10.12.0 e posteriores para melhorar o desempenho em tempo real do IMCI.

    polar_csi.update_batch_count

    1024~4294967295

    100000

    Limiar para o número de linhas atualizadas em um lote.

    Defina o número máximo de linhas em uma única transação de atualização. Aumentar esse limiar melhora a eficiência da atualização de dados.

    Nota

    • PostgreSQL 14: parâmetro adicionado na versão secundária do mecanismo 2.0.14.13.28.0 e posteriores para melhorar o desempenho em tempo real do IMCI.

    • PostgreSQL 16: parâmetro adicionado na versão secundária do mecanismo 2.0.16.10.12.0 e posteriores para melhorar o desempenho em tempo real do IMCI.

    polar_csi.forward_replay_wait

    on|off

    off

    Nível de consistência da consulta de dados do IMCI do IMCI. Valores válidos:

    • off: consistência eventual. Os dados do IMCI podem ficar atrasados em relação aos dados do rowstore.

    • on: consistência forte. As consultas aguardam a reprodução dos dados do columnstore até a versão mais recente antes da execução. Sob alta pressão de gravação, ativar este parâmetro pode causar longos tempos de espera.

    polar_csi.forward_replay_wait_lsn_diff

    0~INT_MAX

    0

    Latência máxima de LSN permitida para sincronização linha-coluna. Se a latência exceder o limiar especificado, o mecanismo columnstore deixará de ser usado. Unidade: BYTE.

    Nota

    • Este parâmetro só entra em vigor quando polar_csi.forward_replay_wait está ativado.

    • Aplica-se apenas às seguintes versões:

      • PostgreSQL 14: versão secundária do mecanismo 2.0.14.19.40.0 e posteriores.

      • PostgreSQL 16: versão secundária do mecanismo 2.0.16.10.12.0 e posteriores.

      • PostgreSQL 15 e PostgreSQL 17: mesma abrangência de aplicação do mecanismo de vetorização.

    polar_csi.sync_addcolumn

    on|off

    off

    Defina se as operações Add Column devem ser sincronizadas com o IMCI.

    Nota

    Aplica-se apenas às seguintes versões:

    • PostgreSQL 14: versão secundária do mecanismo 2.0.14.19.40.0 e posteriores.

    • PostgreSQL 16: versão secundária do mecanismo 2.0.16.10.12.0 e posteriores.

    • PostgreSQL 15 e PostgreSQL 17: mesma abrangência de aplicação do mecanismo de vetorização.

    Tipos de dados

    Categoria

    Tipo de dado

    Tipos de dados básicos

    BOOLEAN, ARRAY, BIT, UUID

    Tipos de string e binários

    BPCHAR, CHAR, VARCHAR, TEXT, NAME, BYTEA

    Tipos de data e hora

    DATE, TIME, TIMESTAMP, TIMESTAMPTZ, INTERVAL

    Tipos numéricos

    BIGINT, DECIMAL, DOUBLE PRECISION, FLOAT4, FLOAT8, INTEGER, NUMERIC, REAL, SERIAL, SHORT, SMALLINT

    Tipos compostos

    JSON, JSONB, ENUM, BITSTRING, VARCHAR[], TEXT[]

    Nota

    • PostgreSQL 14: os tipos de dados BITSTRING, VARCHAR[] e TEXT[] foram adicionados na versão secundária do mecanismo 2.0.14.19.40.0 e posteriores.

    • PostgreSQL 16: os tipos de dados BITSTRING, VARCHAR[] e TEXT[] foram adicionados na versão secundária do mecanismo 2.0.16.10.12.0 e posteriores.