Nesta página, descrevemos as flags de banco de dados que o AlloyDB Omni usa para ativar e gerenciar recursos específicos do mecanismo colunar. Para uma lista de todas as flags de banco de dados compatíveis com o AlloyDB Omni, consulte Flags de banco de dados compatíveis.
As flags marcadas com Reinicializações de instância significam que você precisa reiniciar uma instância do AlloyDB Omni sempre que definir, remover ou modificar essa flag nela. O valor da flag continua na instância até ele ser modificado novamente.
Para instruções sobre como definir uma flag de banco de dados, consulte Configurar flags de banco de dados do AlloyDB Omni.
Ativação
google_columnar_engine.enabled
| Tipo | Boolean |
| Padrão | off |
| Reinicializações de instâncias | Sim |
Se on, ativa o mecanismo
colunar do AlloyDB Omni.
Disposição automática em colunas
google_columnar_engine.enable_auto_columnarization
| Tipo | Boolean |
| Padrão | on |
| Reinicializações de instâncias | Não |
Se on, ativa os recursos de
disposição automática em colunas do mecanismo colunar.
google_columnar_engine.relations
| Tipo | String |
| Padrão | Uma string vazia |
| Reinicializações de instâncias | Não |
Especifica uma lista de colunas para o AlloyDB Omni adicionar ao repositório de colunas do cluster, além do processo de disposição automática em colunas. Essas colunas podem vir de qualquer tabela no cluster.
O valor da flag é formatado como uma lista de itens separada 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 manualmente o conteúdo do repositório de colunas.
google_columnar_engine.auto_columnarization_schedule
| Tipo | String |
| Padrão | Uma string vazia |
| Reinicializações de instâncias | Não |
| Valor máximo permitido | 2147483647 |
Especifica a frequência com que o AlloyDB Omni executa o processo de disposição automática em colunas 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:
DAYSouHOURS.
Se não for definido, o AlloyDB Omni vai executar o processo de disposição automática em colunas a cada hora.
Dimensionamento e processamento de consultas
google_columnar_engine.memory_size_in_mb
| Tipo | Integer |
| Valores válidos | Entre 128 e o valor que representa 70% da memória da instância |
| Padrão | 1 GB de memória da instância |
| Reinicializações de instâncias | Sim |
A quantidade de memória da instância, expressa em mebibytes (MiB), que o AlloyDB Omni aloca para o repositório de colunas.
Se essa flag não estiver definida, o AlloyDB Omni vai alocar 1 GB da memória da instância para o repositório de colunas.
google_columnar_engine.enable_columnar_scan
| Tipo | Boolean |
| Padrão | on |
| Reinicializações de instâncias | Não |
Se on, permite que o AlloyDB Omni acesse dados no repositório 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 repositório de colunas, mas
o AlloyDB Omni não usará dados colunares ao processar consultas.
google_columnar_engine.omni_storage_cache_directory
Essa flag permite especificar um caminho de diretório dedicado separado para arquivos de cache em disco do mecanismo colunar.
| Tipo | String |
| Valores válidos | Um único caminho de diretório em que os arquivos de cache em disco são armazenados. |
| Padrão | O tamanho total da Declaração de Volume Permanente (PVC) dedicada é alocado para o cache de distribuição em disco colunar. |
| Reinicializações de instâncias | Sim |
google_columnar_engine.storage_cache_size
Se google_columnar_engine.omni_storage_cache_directory não for especificado, para ativar o tamanho do cache de armazenamento, ative o cache em disco.
| Tipo | Integer |
| Valores válidos | 1024 ... 2147483647 |
| Padrão | 5% do cache em disco são alocados para o mecanismo colunar quando google_columnar_engine.omni_storage_cache_directory não é especificado. |
| Reinicializações de instâncias | Sim |
Se on, permite que o AlloyDB Omni configure o tamanho do cache de armazenamento para o mecanismo colunar.
Quando google_columnar_engine.omni_storage_cache_directory não é especificado, o valor máximo permitido para essa flag é 50% do cache em disco total. O limite de 1.000 * google_columnar_engine.memory_size_in_mb também se aplica.
Atividades de manutenção
google_job_scheduler.maintenance_cpu_percentage
| Tipo | Integer |
| Valores válidos | 0 ... 100 |
| Padrão | 20 |
| Reinicializações de instâncias | Nã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
| Tipo | Integer |
| Valores válidos | 0 ... 262143 |
| Padrão | 2 |
| Reinicializações de instâncias | Não |
É o número máximo de workers paralelos que o mecanismo colunar pode criar para realizar qualquer operação de processamento em segundo plano.
Atualização automática: orientada por eventos
google_columnar_engine.refresh_threshold_percentage
| Tipo | Integer |
| Valores válidos | 1 ... 100 |
| Padrão | 50 |
| Reinicializações de instâncias | Não |
Especifica o limite de atualização de dados do armazenamento de colunas, expresso com uma porcentagem.
O AlloyDB Omni atualiza os dados em uma unidade colunar (um conjunto de blocos de dados em uma tabela colunar) quando as seguintes condições são atendidas:
A tabela da unidade colunar excedeu o limite de verificação definido pela flag
refresh_threshold_scan_countseparada.A porcentagem 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 colunares ficam inválidos devido a alterações nos dados baseados em linhas que a tabela usa.
google_columnar_engine.refresh_threshold_scan_count
| Tipo | Integer |
| Valores válidos | 0 ... 2147483647 |
| Padrão | 5 |
| Reinicializações de instâncias | Não |
O AlloyDB 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 colunar antes que o AlloyDB Omni possa atualizar os dados. A partir
daí, 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
vai ignorar as verificações de tabela para determinar quando atualizar os dados colunares, usando apenas
refresh_threshold_percentage.
Atualização automática: periódica e adaptativa
google_columnar_engine.adaptive_auto_refresh_schedule
| Tipo | String |
| Padrão | Uma string vazia |
| Reinicializações de instâncias | Não |
| Valor máximo permitido | 2147483647 |
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 o seguinte:
NUMBER: um número inteiro positivo.
TIME_UNITS:
DAYSouHOURS.
Se não for definido, o AlloyDB Omni vai executar o processo de Atualização Automática Adaptativa uma vez por hora.
google_columnar_engine. min_adaptive_auto_refresh_blocks
| Tipo | Integer |
| Valores válidos | 0 ... 2147483647 |
| Padrão | 50 |
| Reinicializações de instâncias | Nã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 colunares ficam inválidos devido a mudanças nos dados baseados
em linhas que a tabela usa.
Mesclagem vetorizada
google_columnar_engine.enable_vectorized_join
| Tipo | Boolean |
| Padrão | off |
| Reinicia a instância | No |
Se on, o AlloyDB Omni usará automaticamente operações vetorizadas
multithread para melhorar o desempenho de consultas que mesclam várias tabelas.
Para mais informações, consulte Ativar mesclagens vetorizadas.
google_columnar_engine.vectorized_join_threads
| Tipo | Integer |
| Valores válidos | Até metade da contagem de vCPUs da instância |
| Padrão | 1 |
| Reinicia a instância | No |
Define o número máximo de linhas de execução paralelas disponíveis para o operador de mesclagem
vetorizada, 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.
Recursos em fase de pré-lançamento
google_columnar_engine.enable_json_support
| Tipo | Boolean |
| Padrão | off |
| Reinicia a instância | No |
Se esta flag e enable_raw_format estiverem definidas como on, o
AlloyDB Omni permitirá tipos de dados JSON e JSONB do PostgreSQL no repositório de colunas.
google_columnar_engine.enable_raw_format
| Tipo | Boolean |
| Padrão | off |
| Reinicia a instância | No |
Se esta flag e enable_json_support estiverem definidas como on,
o AlloyDB Omni vai permitir tipos de dados JSON e JSONB do PostgreSQL no repositório de colunas.