Configura el motor de columnas en AlloyDB Omni

En esta página, se describe cómo habilitar o inhabilitar el motor de columnas en un clúster de bases de datos de AlloyDB Omni. También se explica cómo configurar un tamaño inicial adecuado para su almacén de columnas.

Para usar el motor de columnas cuando usas AlloyDB para PostgreSQL en Google Cloud, consulta Cómo configurar el motor de columnas.

Para obtener una descripción general conceptual del motor de columnas de AlloyDB, consulta Acerca del motor de columnas de AlloyDB.

Habilita el motor de columnas

Para usar el motor de columnas en una instancia, establece la marca google_columnar_engine.enabled de la instancia en on.

Para establecer esta marca en una instancia, haz lo siguiente:

  1. Ejecuta el comando ALTER SYSTEM de PostgreSQL:

    ALTER SYSTEM SET google_columnar_engine.enabled = 'on'

  2. Si deseas ajustar la configuración del motor de columnas, sigue las instrucciones de la siguiente sección antes de reiniciar el servidor de la base de datos. De lo contrario, sigue los siguientes dos pasos para reiniciar el servidor de base de datos ahora.

  3. Detén el servidor de base de datos.

  4. Inicia el servidor de base de datos.

Configura el tamaño del almacén de columnas

Mientras el motor de columnas está habilitado en una instancia, AlloyDB asigna una parte de la memoria de la instancia para almacenar sus datos de columnas. Si dedicas RAM de alta velocidad a tu almacén de columnas, seguro que AlloyDB puede acceder a los datos de columnas lo más rápido posible.

También puedes establecer la asignación en un tamaño fijo y específico con la marca google_columnar_engine.memory_size_in_mb.

Para establecer esta marca en una instancia, haz lo siguiente:

  1. Ejecuta el comando ALTER SYSTEM de PostgreSQL:

    ALTER SYSTEM SET google_columnar_engine.memory_size_in_mb = COLUMN_STORE_SIZE;

    Reemplaza COLUMN_STORE_SIZE por el nuevo tamaño del almacén de columnas, en megabytes.

  2. Detén el servidor de base de datos.

  3. Inicia el servidor de base de datos.

Habilita la unión vectorizada

El motor de columnas tiene una función de unión vectorizada que puede mejorar el rendimiento de las uniones aplicando el procesamiento vectorizado a las consultas que cumplen con los requisitos.

Después de habilitar la unión vectorizada, el planificador de consultas de AlloyDB tiene la opción de aplicar el operador de unión vectorizada en lugar del operador de unión hash estándar de PostgreSQL. Para tomar esta decisión, el planificador compara el costo de ejecutar la consulta con cualquiera de los métodos.

Para habilitar la unión vectorizada en una instancia, establece la marca google_columnar_engine.enable_vectorized_join de la instancia en on.

Para establecer esta marca en una instancia, ejecuta el comando ALTER SYSTEM de PostgreSQL:

ALTER SYSTEM SET google_columnar_engine.enable_vectorized_join = 'on';

De forma predeterminada, AlloyDB asigna un subproceso a la función de unión vectorizada. Para aumentar la cantidad de subprocesos disponibles para esta función, establece la marca google_columnar_engine.vectorized_join_threads en un valor mayor.

Actualiza manualmente el motor de columnas

De forma predeterminada, el motor de columnas está configurado para actualizar automáticamente el almacén de columnas en segundo plano cuando está habilitado. Es posible que debas actualizar manualmente el almacén columnar en ciertas situaciones, por ejemplo, si la actualización automática no actualiza una relación con una gran cantidad de bloques no válidos.

Para actualizar manualmente el motor de columnas, ejecuta la siguiente consulta en SQL:

SELECT google_columnar_engine_refresh('TABLE_NAME');

Reemplaza TABLE_NAME por el nombre de la tabla o la vista materializada que deseas actualizar de forma manual.

Inhabilita el motor de columnas

Para inhabilitar el motor de columbar en una instancia, establece la marca google_columnar_engine.enabled en off.

Para establecer esta marca en una instancia, haz lo siguiente:

  1. Ejecuta el comando ALTER SYSTEM de PostgreSQL:

    ALTER SYSTEM SET google_columnar_engine.enabled = 'off'

  2. Detén el servidor de base de datos.

  3. Inicia el servidor de base de datos.

Soluciona problemas relacionados con el motor de columnas

Cómo corregir un error de "memoria compartida insuficiente"

Si ejecutas AlloyDB Omni sin suficiente memoria compartida para que el motor de columnas la use, es posible que veas este error:

Insufficient shared memory for generating the columnar formats.

Para solucionar este problema, especifica la cantidad de memoria compartida que está disponible para el contenedor de AlloyDB Omni. La forma de hacerlo difiere según el sistema operativo del host.

Linux

Aumenta el tamaño de la partición /dev/shm de la máquina anfitrión con una técnica como editar el archivo /etc/fstab.

macOS

Instala un nuevo contenedor de AlloyDB Omni y especifica un valor de memoria compartida más grande para la marca --shm-size.

Se corrigió el problema por el que no se propagaban las columnas

Si las columnas no se propagan en el motor de columnas, es posible que se cumpla una de las siguientes situaciones:

  • Las columnas que deseas agregar incluyen un tipo de datos no admitido.

  • No se cumplen los requisitos del motor de columnas.

Para encontrar la causa de este problema, prueba lo siguiente:

  • Confirma que las tablas o las vistas materializadas de nuestra consulta estén en el motor de columnas.

  • Verifica el uso del motor de columnas con la sentencia EXPLAIN.

¿Qué sigue?