Flags do mecanismo colunar

Esta página descreve as flags do banco de dados que o AlloyDB Omni usa para ativar e gerenciar recursos específicos do motor de colunas. Para uma lista de todas as flags de banco de dados com suporte ao AlloyDB Omni, consulte Flags de banco de dados com suporte.

As flags marcadas com Instance restarts significam que você precisa reiniciar uma instância do AlloyDB Omni sempre que definir, remover ou modificar essa flag na instância. O valor da flag persiste na instância até que você o modifique novamente.

Para instruções sobre como definir uma flag do banco de dados, consulte Configurar flags do banco de dados do AlloyDB Omni.

Ativação

google_columnar_engine.enabled

TipoBoolean
Padrãooff
Reinicializações de instânciaSim

Se on, ativa o motor de colunas do AlloyDB Omni.

Disposição automática em colunas

google_columnar_engine.enable_auto_columnarization

TipoBoolean
Padrãoon
Reinicializações de instânciaNão

Se on, ativa os recursos de autocolunização do mecanismo colunar.

google_columnar_engine.relations

TipoString
PadrãoUma string vazia
Reinicializações de instânciaNão

Especifica uma lista de colunas para o AlloyDB Omni adicionar ao armazenamento de colunas do cluster, além do processo de autocolunização. Essas colunas podem vir de qualquer tabela no cluster.

O valor da flag é formatado como uma lista de itens separados por vírgulas. Cada item especifica uma ou mais colunas de uma única tabela, expressas neste formato:

'DATABASE_NAME.SCHEMA_NAME.TABLE_NAME(COLUMN_LIST)'

Para mais informações, consulte Gerenciar o conteúdo do armazenamento de colunas manualmente.

google_columnar_engine.auto_columnarization_schedule

TipoString
PadrãoUma string vazia
Reinicializações de instânciaNão
Valor máximo permitido2147483647

Especifica a frequência com que o AlloyDB Omni executa o processo de autocolunização na instância.

O valor é uma string no seguinte formato:

'EVERY NUMBER TIME_UNITS'

Substitua:

  • NUMBER: um número inteiro positivo.

  • TIME_UNITS: DAYS ou HOURS.

Se não for definido, o AlloyDB Omni vai executar o processo de colunarização automática uma vez por hora.

Dimensionamento e processamento de consultas

google_columnar_engine.memory_size_in_mb

TipoInteger
Valores válidosEntre 128 e o valor que representa 70% da memória da instância
Padrão1 GB de memória da instância
Reinicializações de instânciaSim

A quantidade de memória da instância, expressa em mebibytes (MiB), que o AlloyDB Omni aloca para o armazenamento de colunas.

Se essa flag não estiver definida, o AlloyDB Omni vai alocar 1 GB da memória da instância para o armazenamento de colunas.

google_columnar_engine.enable_columnar_scan

TipoBoolean
Padrãoon
Reinicializações de instânciaNão

Se on, permite que o AlloyDB Omni acesse dados no armazenamento de colunas ao processar consultas.

Se essa flag for off enquanto google_columnar_engine.enabled for on, o mecanismo colunar vai permanecer ativado e manter o armazenamento de colunas, mas o AlloyDB Omni não vai usar dados colunares ao processar consultas.

google_columnar_engine.storage_cache_size

Para ativar o tamanho do cache de armazenamento, é necessário ativar o cache de disco.

TipoInteger
Valores válidos1024 ... 2147483647
Padrão5% of the disk cache is allocated to the columnar engine
Reinicializações de instânciaSim

Se on, permite que o AlloyDB Omni configure o tamanho do cache de armazenamento para o mecanismo de colunas.

O valor máximo permitido para essa flag é de 50% do cache total do disco ou 1.000 * google_columnar_engine.memory_size_in_mb, o que for menor.

Atividades de manutenção

google_job_scheduler.maintenance_cpu_percentage

TipoInteger
Valores válidos0 ... 100
Padrão20
Reinicializações de instânciaNão

É a porcentagem máxima da capacidade da CPU de uma instância que o mecanismo colunar pode aplicar ao processamento em segundo plano.

google_job_scheduler.max_parallel_workers_per_job

TipoInteger
Valores válidos0 ... 262143
Padrão2
Reinicializações de instânciaNão

É o número máximo de workers paralelos que o mecanismo colunar pode criar para processar qualquer operação de processamento em segundo plano.

Atualização automática: baseada em eventos

google_columnar_engine.refresh_threshold_percentage

TipoInteger
Valores válidos1 ... 100
Padrão50
Reinicializações de instânciaNão

Especifica o limite de atualização de dados do armazenamento de colunas, expresso em porcentagem.

O AlloyDB Omni atualiza os dados em uma unidade de coluna, um conjunto de blocos de dados em uma tabela de colunas, quando as seguintes condições são atendidas:

  • A tabela da unidade colunar excedeu o limite de verificação definido pela flag separada refresh_threshold_scan_count.

  • A porcentagem dos blocos de dados subjacentes da unidade de coluna que se tornaram inválidos excede o valor da flag refresh_threshold_percentage. Os blocos de dados em colunas se tornam inválidos devido a mudanças nos dados baseados em linhas que a tabela em colunas usa.

google_columnar_engine.refresh_threshold_scan_count

TipoInteger
Valores válidos0 ... 2147483647
Padrão5
Reinicializações de instânciaNão

O AlloyDB Omni mantém uma contagem em execução das verificações de tabelas realizadas em cada tabela colunar desde a consulta DML mais recente. O valor da flag refresh_threshold_scan_count especifica o valor mínimo desse contador em qualquer tabela de colunas antes que o AlloyDB Omni possa atualizar os dados. Em seguida, o AlloyDB Omni usa o limite de bloco inválido definido por refresh_threshold_percentage para determinar quando atualizar os dados da tabela.

Se o valor dessa flag for definido como 0, o AlloyDB Omni ignorará as verificações de tabela para determinar quando atualizar os dados de coluna, usando apenas refresh_threshold_percentage.

Atualização automática: periódica e adaptativa

google_columnar_engine.adaptive_auto_refresh_schedule

TipoString
PadrãoUma string vazia
Reinicializações de instânciaNão
Valor máximo permitido2147483647

Especifica a frequência com que o AlloyDB Omni executa o processo de atualização automática adaptativa na instância.

O valor é uma string no seguinte formato:

'EVERY NUMBER TIME_UNITS'

Substitua:

  • NUMBER: um número inteiro positivo.

  • TIME_UNITS: DAYS ou HOURS.

Se não for definido, o AlloyDB Omni vai executar o processo de atualização automática adaptativa uma vez a cada hora.

google_columnar_engine. min_adaptive_auto_refresh_blocks

TipoInteger
Valores válidos0 ... 2147483647
Padrão50
Reinicializações de instânciaNão

O número de blocos de dados subjacentes da unidade colunar que se tornaram inválidos excede o valor da flag min_adaptive_auto_refresh_blocks. Os blocos de dados em colunas se tornam inválidos devido a mudanças nos dados baseados em linha que a tabela em colunas usa.

Mesclagem vetorizada

google_columnar_engine.enable_vectorized_join

TipoBoolean
Padrãooff
Reinicia a instânciaNo

Se on, o AlloyDB Omni usa automaticamente operações vetorizadas multithread para melhorar o desempenho de consultas que unem várias tabelas.

Para mais informações, consulte Ativar mesclagens vetorizadas.

google_columnar_engine.vectorized_join_threads

TipoInteger
Valores válidosAté metade da contagem de vCPUs da instância
Padrão1
Reinicia a instânciaNo

Define o número máximo de linhas de execução paralelas disponíveis para o operador de mesclagem vetorial, ativado pela flag enable_vectorized_join.

É possível definir um valor de até metade das vCPUs da instância. Por exemplo, em uma instância de 16 vCPUs, o valor máximo dessa flag é 8.

Prévia dos recursos

google_columnar_engine.enable_json_support

TipoBoolean
Padrãooff
Reinicia a instânciaNo

Se essa flag e enable_raw_format estiverem definidas como on, o AlloyDB Omni vai permitir tipos de dados JSON e JSONB do PostgreSQL no armazenamento de colunas.

google_columnar_engine.enable_raw_format

TipoBoolean
Padrãooff
Reinicia a instânciaNo

Se essa flag e enable_json_support estiverem definidas como on, o AlloyDB Omni vai permitir tipos de dados JSON e JSONB do PostgreSQL no armazenamento de colunas.