Sinalizações do motor colunar

Selecione uma versão da documentação:

Esta página descreve as flags da base de dados que o AlloyDB Omni usa para ativar e gerir funcionalidades específicas do motor de colunas. Para ver uma lista de todas as flags de base de dados que o AlloyDB Omni suporta, consulte o artigo Flags de base de dados suportadas.

As flags marcadas com Reinícios da instância significam que tem de reiniciar uma instância do AlloyDB Omni sempre que definir, remover ou modificar esta flag nessa instância. O valor da flag persiste para a instância até que o modifique novamente.

Para ver instruções sobre como definir uma flag de base de dados, consulte o artigo Configure flags de base de dados do AlloyDB Omni.

Ativação

google_columnar_engine.enabled

TipoBoolean
Predefiniçãooff
Reinícios da instânciaSim

Se on, ativa o motor colunar do AlloyDB Omni.

Organização automática em colunas

google_columnar_engine.enable_auto_columnarization

TipoBoolean
Predefiniçãoon
Reinícios da instânciaNão

Se on, ativa as funcionalidades de columnarização automática do motor de colunas.

google_columnar_engine.relations

TipoString
PredefiniçãoUma string vazia
Reinícios da instânciaNão

Especifica uma lista de colunas para o AlloyDB Omni adicionar ao armazenamento de colunas do cluster, além do processo de auto-colunarização. Estas colunas podem ser provenientes de quaisquer tabelas no cluster.

O valor da flag está 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 o artigo Faça a gestão manual do conteúdo da base de dados de colunas.

google_columnar_engine.auto_columnarization_schedule

TipoString
PredefiniçãoUma string vazia
Reinícios da instânciaNão
Valor máximo permitido2147483647

Especifica a frequência com que o AlloyDB Omni executa o processo de auto-columnarization na instância.

O valor é uma string no seguinte formato:

'EVERY NUMBER TIME_UNITS'

Substitua o seguinte:

  • NUMBER: um número inteiro positivo.

  • TIME_UNITS: DAYS ou HOURS.

Se não for definido, o AlloyDB Omni executa o processo de columnarizaçã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
Predefinição1 GB de memória da instância
Reinícios da instânciaSim

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

Se esta flag não estiver definida, o AlloyDB Omni atribui 1 GB da memória da instância ao armazenamento de colunas.

google_columnar_engine.enable_columnar_scan

TipoBoolean
Predefiniçãoon
Reinícios da instânciaNão

Se on, permite que o AlloyDB Omni aceda aos dados no armazenamento de colunas quando processa consultas.

Se este sinalizador for off enquanto google_columnar_engine.enabled for on, o motor de colunas permanece ativado e mantém o respetivo armazenamento de colunas, mas o AlloyDB Omni não usa dados de colunas quando processa consultas.

google_columnar_engine.storage_cache_size

Para ativar o tamanho da cache de armazenamento, tem de ativar a cache de disco.

TipoInteger
Valores válidos1024 ... 2147483647
Predefinição5% of the disk cache is allocated to the columnar engine
Reinícios da instânciaSim

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

O valor máximo permitido para esta flag é 50% da cache de disco total ou 1000 * google_columnar_engine.memory_size_in_mb, consoante o que for inferior.

Atividades de manutenção

google_job_scheduler.maintenance_cpu_percentage

TipoInteger
Valores válidos0 ... 100
Predefinição20
Reinícios da instânciaNão

A percentagem máxima da capacidade da CPU de uma instância que o motor de colunas pode aplicar ao processamento em segundo plano.

google_job_scheduler.max_parallel_workers_per_job

TipoInteger
Valores válidos0 ... 262143
Predefinição2
Reinícios da instânciaNão

O número máximo de trabalhadores paralelos que o motor de colunas 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
Predefinição50
Reinícios da instânciaNão

Especifica o limite de atualização de dados da base de dados de colunas, expresso como uma percentagem.

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

  • A tabela da unidade colunar excedeu o limite de análise definido pela flag refresh_threshold_scan_count separada.

  • A percentagem de blocos de dados subjacentes da unidade colunar que se tornaram inválidos excede o valor da flag refresh_threshold_percentage. Os blocos de dados em colunas tornam-se inválidos devido a alterações nos dados baseados em linhas que a tabela em colunas usa.

google_columnar_engine.refresh_threshold_scan_count

TipoInteger
Valores válidos0 ... 2147483647
Predefinição5
Reinícios da instânciaNão

O AlloyDB Omni mantém uma contagem contínua das análises de tabelas realizadas em cada tabela de colunas desde a consulta DML mais recente dessa tabela. O valor da flag refresh_threshold_scan_count especifica o valor mínimo deste contador em qualquer tabela de colunas antes de o AlloyDB Omni poder atualizar os respetivos dados. A partir daí, o AlloyDB Omni usa o limite de blocos inválidos definido por refresh_threshold_percentage para determinar quando atualizar os dados da tabela.

Se o valor desta flag estiver definido como 0, o AlloyDB Omni ignora as análises de tabelas para determinar quando atualizar os dados em colunas, usando apenas refresh_threshold_percentage.

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

google_columnar_engine.adaptive_auto_refresh_schedule

TipoString
PredefiniçãoUma string vazia
Reinícios da instânciaNão
Valor máximo permitido2147483647

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

O valor é uma string no seguinte formato:

'EVERY NUMBER TIME_UNITS'

Substitua o seguinte:

  • NUMBER: um número inteiro positivo.

  • TIME_UNITS: DAYS ou HOURS.

Se não for definido, o AlloyDB Omni executa o processo de atualização automática adaptativa uma vez por hora.

google_columnar_engine. min_adaptive_auto_refresh_blocks

TipoInteger
Valores válidos0 ... 2147483647
Predefinição50
Reinícios da 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 tornam-se inválidos devido a alterações nos dados baseados em linhas que a tabela em colunas usa.

Junção vetorizada

google_columnar_engine.enable_vectorized_join

TipoBoolean
Predefiniçãooff
Reinicia a instânciaNo

Se on, o AlloyDB Omni usa automaticamente operações vetorizadas com várias linhas de execução para melhorar o desempenho das consultas que juntam várias tabelas.

Para mais informações, consulte o artigo Ative as junções vetorizadas.

google_columnar_engine.vectorized_join_threads

TipoInteger
Valores válidosAté metade do número de vCPUs da instância
Predefinição1
Reinicia a instânciaNo

Define o número máximo de threads paralelos disponíveis para o operador de junção vetorizada, ativado pela flag enable_vectorized_join.

Pode definir um valor até metade das vCPUs da instância. Por exemplo, numa instância de 16 vCPUs, o valor máximo desta flag é 8.

Funcionalidades de pré-visualização

google_columnar_engine.enable_json_support

TipoBoolean
Predefiniçãooff
Reinicia a instânciaNo

Se este indicador e enable_raw_format estiverem definidos como on, o AlloyDB Omni permite tipos de dados JSON e JSONB do PostgreSQL no arquivo de colunas.

google_columnar_engine.enable_raw_format

TipoBoolean
Predefiniçãooff
Reinicia a instânciaNo

Se este indicador e enable_json_support estiverem definidos como on, o AlloyDB Omni permite tipos de dados JSON e JSONB do PostgreSQL no arquivo de colunas.