Marcas del motor en columnas

Selecciona una versión de la documentación:

En esta página se describen las marcas de base de datos que usa AlloyDB Omni para habilitar y gestionar funciones específicas de su motor columnar. Para ver una lista de todas las marcas de base de datos que admite AlloyDB Omni, consulta Marcas de base de datos admitidas.

Las marcas con la etiqueta Reinicios de instancias significan que debes reiniciar una instancia de AlloyDB Omni cada vez que definas, quites o modifiques esta marca en esa instancia. El valor de la marca se mantiene en la instancia hasta que lo vuelvas a modificar.

Para obtener instrucciones sobre cómo definir una marca de base de datos, consulta Configurar marcas de bases de datos de AlloyDB Omni.

Habilitación

google_columnar_engine.enabled

TipoBoolean
Predeterminadooff
Reinicios de instancias

Si on, habilita el motor columnar de AlloyDB Omni.

Columnización automática

google_columnar_engine.enable_auto_columnarization

TipoBoolean
Predeterminadoon
Reinicios de instanciasNo

Si on, habilita las funciones de columnarización automática del motor en columnas.

google_columnar_engine.relations

TipoString
PredeterminadoUna cadena vacía
Reinicios de instanciasNo

Especifica una lista de columnas que AlloyDB Omni debe añadir al almacén de columnas de tu clúster, además del proceso de columnarización automática. Estas columnas pueden proceder de cualquier tabla de tu clúster.

El valor de la marca tiene el formato de una lista de elementos separados por comas. Cada elemento especifica una o varias columnas de una sola tabla, expresadas en este formato:

'DATABASE_NAME.SCHEMA_NAME.TABLE_NAME(COLUMN_LIST)'

Para obtener más información, consulta Gestionar manualmente el contenido de un almacén de columnas.

google_columnar_engine.auto_columnarization_schedule

TipoString
PredeterminadoUna cadena vacía
Reinicios de instanciasNo
Valor máximo permitido2147483647

Especifica la frecuencia con la que AlloyDB Omni ejecuta su proceso de columnarización automática en la instancia.

El valor es una cadena con el siguiente formato:

'EVERY NUMBER TIME_UNITS'

Haz los cambios siguientes:

  • NUMBER: un número entero positivo.

  • TIME_UNITS: DAYS o HOURS.

Si no se define, AlloyDB Omni ejecuta el proceso de columnarización automática una vez cada hora.

Tamaño y procesamiento de consultas

google_columnar_engine.memory_size_in_mb

TipoInteger
Valores válidosEntre 128 y el valor que representa el 70% de la memoria de la instancia
Predeterminado1 GB de memoria de instancia
Reinicios de instancias

Cantidad de memoria de la instancia, expresada en mebibytes (MiB), que AlloyDB Omni asigna al almacén de columnas.

Si no se define esta marca, AlloyDB Omni asigna 1 GB de la memoria de la instancia al almacén de columnas.

google_columnar_engine.enable_columnar_scan

TipoBoolean
Predeterminadoon
Reinicios de instanciasNo

Si on, permite que AlloyDB Omni acceda a los datos del almacén de columnas al gestionar consultas.

Si esta marca es off mientras que google_columnar_engine.enabled es on, el motor columnar permanece habilitado y conserva su almacén de columnas, pero AlloyDB Omni no usa datos de columnas cuando gestiona consultas.

google_columnar_engine.storage_cache_size

Para habilitar el tamaño de la caché de almacenamiento, debes habilitar la caché de disco.

TipoInteger
Valores válidos1024 ... 2147483647
Predeterminado5% of the disk cache is allocated to the columnar engine
Reinicios de instancias

Si on, AlloyDB Omni permite configurar el tamaño de la caché de almacenamiento del motor de columnas.

El valor máximo permitido para esta marca es el 50% de la caché de disco total o 1000 * google_columnar_engine.memory_size_in_mb (el valor que sea inferior).

Actividades de mantenimiento

google_job_scheduler.maintenance_cpu_percentage

TipoInteger
Valores válidos0 ... 100
Predeterminado20
Reinicios de instanciasNo

Porcentaje máximo de la capacidad de CPU de una instancia que el motor columnar puede aplicar al procesamiento en segundo plano.

google_job_scheduler.max_parallel_workers_per_job

TipoInteger
Valores válidos0 ... 262143
Predeterminado2
Reinicios de instanciasNo

Número máximo de trabajadores paralelos que el motor columnar puede crear para gestionar cualquier operación de procesamiento en segundo plano.

Actualización automática basada en eventos

google_columnar_engine.refresh_threshold_percentage

TipoInteger
Valores válidos1 ... 100
Predeterminado50
Reinicios de instanciasNo

Especifica el umbral de actualización de datos del almacén de columnas, expresado como porcentaje.

AlloyDB Omni actualiza los datos de una unidad columnar (un conjunto de bloques de datos de una tabla columnar) cuando se cumplen las siguientes condiciones:

  • La tabla de la unidad columnar ha superado el umbral de análisis definido por la marca refresh_threshold_scan_count independiente.

  • El porcentaje de los bloques de datos subyacentes de la unidad columnar que se han convertido en no válidos supera el valor de la marca refresh_threshold_percentage. Los bloques de datos de columnas dejan de ser válidos debido a los cambios en los datos basados en filas de los que se nutre la tabla de columnas.

google_columnar_engine.refresh_threshold_scan_count

TipoInteger
Valores válidos0 ... 2147483647
Predeterminado5
Reinicios de instanciasNo

AlloyDB Omni mantiene un recuento continuo de los análisis de tablas realizados en cada tabla de columnas desde la consulta DML más reciente de esa tabla. El valor de la marca refresh_threshold_scan_count especifica el valor mínimo de este contador en cualquier tabla columnar antes de que AlloyDB Omni pueda actualizar sus datos. A partir de ahí, AlloyDB Omni usa el umbral de bloques no válidos definido por refresh_threshold_percentage para determinar cuándo actualizar los datos de la tabla.

Si el valor de esta marca es 0, AlloyDB Omni no tiene en cuenta los análisis de tablas para determinar cuándo actualizar los datos de las columnas y solo usa refresh_threshold_percentage.

Actualización automática: periódica y adaptativa

google_columnar_engine.adaptive_auto_refresh_schedule

TipoString
PredeterminadoUna cadena vacía
Reinicios de instanciasNo
Valor máximo permitido2147483647

Especifica la frecuencia con la que AlloyDB Omni ejecuta su proceso de actualización automática adaptativa en la instancia.

El valor es una cadena con el siguiente formato:

'EVERY NUMBER TIME_UNITS'

Haz los cambios siguientes:

  • NUMBER: un número entero positivo.

  • TIME_UNITS: DAYS o HOURS.

Si no se define, AlloyDB Omni ejecuta el proceso de actualización automática adaptativa una vez cada hora.

google_columnar_engine. min_adaptive_auto_refresh_blocks

TipoInteger
Valores válidos0 ... 2147483647
Predeterminado50
Reinicios de instanciasNo

El número de bloques de datos subyacentes de la unidad columnar que han dejado de ser válidos supera el valor de la marca min_adaptive_auto_refresh_blocks. Los bloques de datos de columnas dejan de ser válidos debido a los cambios en los datos basados en filas de los que se nutre la tabla de columnas.

Combinación vectorizada

google_columnar_engine.enable_vectorized_join

TipoBoolean
Predeterminadooff
Reinicia la instancia.No

Si on, AlloyDB Omni usa automáticamente operaciones vectorizadas multihilo para mejorar el rendimiento de las consultas que combinan varias tablas.

Para obtener más información, consulta Habilitar las combinaciones vectorizadas.

google_columnar_engine.vectorized_join_threads

TipoInteger
Valores válidosHasta la mitad del número de vCPUs de la instancia
Predeterminado1
Reinicia la instancia.No

Define el número máximo de hilos paralelos disponibles para el operador de unión vectorizada, habilitado por la marca enable_vectorized_join.

Puede definir un valor de hasta la mitad de las vCPUs de la instancia. Por ejemplo, en una instancia de 16 vCPUs, el valor máximo de esta marca es 8.

Funciones de vista previa

google_columnar_engine.enable_json_support

TipoBoolean
Predeterminadooff
Reinicia la instancia.No

Si se definen en on tanto esta marca como enable_raw_format, AlloyDB Omni permite los tipos de datos JSON y JSONB de PostgreSQL en el almacén de columnas.

google_columnar_engine.enable_raw_format

TipoBoolean
Predeterminadooff
Reinicia la instancia.No

Si tanto esta marca como enable_json_support tienen el valor on, AlloyDB Omni permite los tipos de datos JSON y JSONB de PostgreSQL en el almacén de columnas.