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
Tipo | Boolean |
Predeterminado | off |
Reinicios de instancias | Sí |
Si on
, habilita el motor columnar de AlloyDB Omni.
Columnización automática
google_columnar_engine.enable_auto_columnarization
Tipo | Boolean |
Predeterminado | on |
Reinicios de instancias | No |
Si on
, habilita las funciones de columnarización automática del motor en columnas.
google_columnar_engine.relations
Tipo | String |
Predeterminado | Una cadena vacía |
Reinicios de instancias | No |
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
Tipo | String |
Predeterminado | Una cadena vacía |
Reinicios de instancias | No |
Valor máximo permitido | 2147483647 |
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
oHOURS
.
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
Tipo | Integer |
Valores válidos | Entre 128 y el valor que representa el 70% de la memoria de la instancia |
Predeterminado | 1 GB de memoria de instancia |
Reinicios de instancias | Sí |
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
Tipo | Boolean |
Predeterminado | on |
Reinicios de instancias | No |
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.
Tipo | Integer |
Valores válidos | 1024 ... 2147483647 |
Predeterminado | 5% of the disk cache is allocated to the columnar engine |
Reinicios de instancias | Sí |
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
Tipo | Integer |
Valores válidos | 0 ... 100 |
Predeterminado | 20 |
Reinicios de instancias | No |
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
Tipo | Integer |
Valores válidos | 0 ... 262143 |
Predeterminado | 2 |
Reinicios de instancias | No |
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
Tipo | Integer |
Valores válidos | 1 ... 100 |
Predeterminado | 50 |
Reinicios de instancias | No |
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
Tipo | Integer |
Valores válidos | 0 ... 2147483647 |
Predeterminado | 5 |
Reinicios de instancias | No |
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
Tipo | String |
Predeterminado | Una cadena vacía |
Reinicios de instancias | No |
Valor máximo permitido | 2147483647 |
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
oHOURS
.
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
Tipo | Integer |
Valores válidos | 0 ... 2147483647 |
Predeterminado | 50 |
Reinicios de instancias | No |
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
Tipo | Boolean |
Predeterminado | off |
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
Tipo | Integer |
Valores válidos | Hasta la mitad del número de vCPUs de la instancia |
Predeterminado | 1 |
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
Tipo | Boolean |
Predeterminado | off |
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
Tipo | Boolean |
Predeterminado | off |
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.