Resolver problemas do mecanismo colunar

Selecione uma versão da documentação:

Nesta página, descrevemos como resolver problemas que podem ocorrer ao usar o mecanismo colunar do AlloyDB Omni. Para mais informações sobre o mecanismo colunar, consulte Visão geral do mecanismo colunar.

Corrigir o erro "memória compartilhada insuficiente"

Se você executar o AlloyDB Omni sem memória compartilhada suficiente para o mecanismo colunar, o seguinte erro poderá aparecer:

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.

Linux

  1. Verifique se você já instalou o AlloyDB Omni com o diretório /dev/shm montado no contêiner. Para mais informações, consulte Personalizar a instalação do AlloyDB Omni.

  2. 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 e especifique um valor de memória compartilhada maior para a flag --shm-size.

Encontre as tabelas preenchidas no mecanismo colunar

Na visualização g_columnar_relations, crie consultas para encontrar as tabelas que estão presentes no mecanismo colunar.

SELECT * FROM g_columnar_relations;

Encontrar a memória geral usada pelo mecanismo colunar

Use a função SQL google_columnar_engine_memory_available() para determinar a quantidade de memória que o mecanismo colunar usa.

SELECT google_columnar_engine_memory_available();

Determinar se colunas específicas não estão preenchidas no mecanismo colunar

Tente as seguintes soluções:

  • Verifique se o mecanismo colunar é compatível com o tipo de dados da coluna.
  • Se você adicionou ou removeu colunas recentemente da tabela base, verifique se realizou a mesma operação no mecanismo colunar.

Verificar se uma consulta usa o mecanismo colunar

No plano de consulta, verifique se há um nó de planejador "Custom Scan (columnar scan)".

Encontrar os jobs de manutenção em andamento

Consulte a visualização g_columnar_jobs para encontrar os jobs em andamento.

SELECT * FROM g_columnar_jobs;

Definir a quantidade de recursos que as atividades de manutenção usam no mecanismo colunar

Por padrão, o mecanismo colunar usa até 20% dos recursos do banco de dados. Para aumentar ou diminuir esse uso, ajuste a configuração google_columnar_engine.maintenance_cpu_percentage (GUC). Para mais informações, consulte Ajustar os recursos de CPU para tarefas de manutenção.