Para usar o mecanismo colunar ao usar o AlloyDB para PostgreSQL no Google Cloud, consulte Configurar o mecanismo colunar.
Para uma visão geral conceitual do mecanismo colunar do AlloyDB, consulte Sobre o mecanismo colunar do AlloyDB.
Ativar o mecanismo colunar
Para usar o mecanismo colunar em uma instância, defina a flag
google_columnar_engine.enabled
da instância como on.
Para definir essa flag em uma instância, faça o seguinte:
Execute o comando
ALTER SYSTEMdo PostgreSQL:ALTER SYSTEM SET google_columnar_engine.enabled = 'on'Se quiser ajustar a configuração do mecanismo colunar, siga as instruções na próxima seção antes de reiniciar o servidor de banco de dados. Caso contrário, siga as próximas duas etapas para reiniciar o servidor de banco de dados agora.
Configurar o tamanho do repositório de colunas
Enquanto o mecanismo colunar está ativado em uma instância, o AlloyDB aloca uma parte da memória da instância para armazenar os dados colunares. Dedicar RAM de alta velocidade ao repositório de colunas garante que o AlloyDB possa acessar os dados colunares o mais rápido possível.
Também é possível definir a alocação para um tamanho fixo e específico usando a flag
google_columnar_engine.memory_size_in_mb.
Para definir essa flag em uma instância, faça o seguinte:
Execute o comando
ALTER SYSTEMdo PostgreSQL:ALTER SYSTEM SET google_columnar_engine.memory_size_in_mb = COLUMN_STORE_SIZE;Substitua
COLUMN_STORE_SIZEpelo novo tamanho do armazenamento de colunas, em megabytes.
Ativar junção vetorizada
O mecanismo colunar tem um recurso de junção vetorizada que pode melhorar o desempenho das junções aplicando o processamento vetorizado a consultas qualificadas.
Depois que você ativa a junção vetorizada, o planejador de consultas do AlloyDB tem a opção de aplicar o operador de junção vetorizada em vez do operador de junção de hash padrão do PostgreSQL. O planejador toma essa decisão comparando o custo de execução da consulta usando cada método.
Para ativar a junção vetorizada em uma instância, defina a flag
google_columnar_engine.enable_vectorized_join
da instância como on.
Para definir essa flag em uma instância, execute o comando ALTER SYSTEM do PostgreSQL:
ALTER SYSTEM SET google_columnar_engine.enable_vectorized_join = 'on';
Atualizar manualmente o mecanismo colunar
Por padrão, o mecanismo colunar é configurado para atualizar automaticamente o repositório de colunas em segundo plano quando ativado. Talvez seja necessário atualizar manualmente o armazenamento colunar em determinadas situações, como se a atualização automática não atualizar uma relação com um grande número de blocos inválidos.
Para atualizar manualmente o mecanismo colunar, execute a seguinte consulta SQL:
SELECT google_columnar_engine_refresh('TABLE_NAME');
Substitua TABLE_NAME pelo nome da tabela ou da visualização materializada que você quer
atualizar manualmente.
Desativar o mecanismo colunar
Para desativar o mecanismo columbar em uma instância, defina a flag google_columnar_engine.enabled
como off.
Para definir essa flag em uma instância, faça o seguinte:
Execute o comando
ALTER SYSTEMdo PostgreSQL:ALTER SYSTEM SET google_columnar_engine.enabled = 'off'
Resolver problemas do mecanismo colunar
Corrigir um erro de "memória compartilhada insuficiente"
Se você executar o AlloyDB Omni sem memória compartilhada suficiente para o mecanismo colunar usar, talvez este erro apareça:
Insufficient shared memory for generating the columnar formats.
Para resolver esse problema, especifique a quantidade de memória compartilhada disponível para o contêiner do AlloyDB Omni. A maneira de fazer isso varia de acordo com o sistema operacional host.
Linux
Aumente o tamanho da partição /dev/shm da máquina host usando uma técnica como a edição do arquivo /etc/fstab.
macOS
Instale um novo contêiner do AlloyDB Omni, especificando
um valor de memória compartilhada maior para a flag --shm-size.
Corrigir colunas que não estão sendo preenchidas
Se as colunas não forem preenchidas no mecanismo colunar, uma das seguintes situações pode ser verdadeira:
As colunas que você quer adicionar incluem um tipo de dados incompatível.
Os requisitos do mecanismo colunar não estão sendo atendidos.
Para encontrar a causa desse problema, tente o seguinte:
Confirme se as tabelas ou visualizações materializadas na consulta estão no mecanismo colunar.
Verifique o uso do mecanismo colunar com a instrução
EXPLAIN.
A seguir
Consulte a lista completa de flags de banco de dados do mecanismo colunar.
Saiba mais sobre a colunarização automática.