En esta página, se describen las marcas de base de datos que AlloyDB Omni usa para habilitar y administrar funciones específicas de su motor columnar. Para obtener una lista de todas las marcas de base de datos que admite AlloyDB Omni, consulta Marcas de base de datos compatibles.
Las marcas marcadas con Reinicio de instancias significan que debes reiniciar una instancia de AlloyDB Omni cada vez que configures, quites o modifiques esta marca en esa instancia. El valor de la marca se conserva para la instancia hasta que la vuelvas a modificar.
Para obtener instrucciones sobre cómo establecer una marca de base de datos, consulta Configura marcas de base de datos de AlloyDB Omni.
Habilitación
google_columnar_engine.enabled
Tipo | Boolean |
Predeterminado | off |
Reinicios de instancias | Sí |
Si es on
, habilita el motor columnar de AlloyDB Omni.
Ordenamiento automático en columnas
google_columnar_engine.enable_auto_columnarization
Tipo | Boolean |
Predeterminado | on |
Reinicios de instancias | No |
Si es on
, habilita las funciones de autocolumnización del motor de columnas.
google_columnar_engine.relations
Tipo | String |
Predeterminado | Una string vacía |
Reinicios de instancias | No |
Especifica una lista de columnas para que AlloyDB Omni las agregue al almacén de columnas de tu clúster, además del proceso de columna automática. Estas columnas pueden provenir 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 más columnas de una sola tabla, expresadas en este formato:
'DATABASE_NAME.SCHEMA_NAME.TABLE_NAME(COLUMN_LIST)'
Para obtener más información, consulta Cómo administrar el contenido del almacén de columnas de forma manual.
google_columnar_engine.auto_columnarization_schedule
Tipo | String |
Predeterminado | Una string vacía |
Reinicios de instancias | No |
Valor máximo permitido | 2147483647 |
Especifica la frecuencia con la que AlloyDB Omni ejecuta su proceso de autocolumnarización en la instancia.
El valor es una cadena con el siguiente formato:
'EVERY NUMBER TIME_UNITS'
Reemplaza lo siguiente:
NUMBER: Es un número entero positivo.
TIME_UNITS por
DAYS
oHOURS
.
Si no se define, AlloyDB Omni ejecuta el proceso de conversión automática a columnas una vez por hora.
Procesamiento de consultas y tamaño
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 la instancia |
Reinicios de instancias | Sí |
Es la cantidad de memoria de instancia, expresada en mebibytes (MiB), que AlloDB Omni asigna al almacén de columnas.
Si no se establece 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 es on
, permite que AlloyDB Omni acceda a los datos del almacén de columnas cuando se manejan consultas.
Si esta marca es off
mientras que google_columnar_engine.enabled
es on
, el motor de columnas permanece habilitado y conserva su almacén de columnas, pero AlloyDB Omni no usa datos de columnas cuando controla las 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 es on
, permite que AlloyDB Omni configure el tamaño de la caché de almacenamiento para el motor de columnas.
El valor máximo permitido para esta marca es el 50% de la caché de disco total o 1,000 × google_columnar_engine.memory_size_in_mb
, lo que sea menor.
Actividades de mantenimiento
google_job_scheduler.maintenance_cpu_percentage
Tipo | Integer |
Valores válidos | 0 ... 100 |
Predeterminado | 20 |
Reinicios de instancias | No |
El porcentaje máximo de la capacidad de CPU de una instancia que el motor de columnas 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 |
La cantidad máxima de trabajadores en paralelo que el motor de columnas puede crear para controlar 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 de la columna, expresado como un porcentaje.
AlloyDB Omni actualiza los datos dentro de una unidad de columna (un conjunto de bloques de datos dentro de una tabla de columnas) cuando se cumplen las siguientes condiciones:
La tabla de la unidad de columna superó el umbral de análisis definido por la marca
refresh_threshold_scan_count
independiente.El porcentaje de bloques de datos subyacentes de la unidad de columnas que se volvió no válido 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 basa 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 actualizado de los análisis de tablas realizados en
cada tabla de columnas desde su consulta de DML más reciente. El valor de la marca refresh_threshold_scan_count
especifica el valor mínimo de este contador en cualquier tabla de columnas antes de que AlloyDB Omni pueda actualizar sus datos. A partir de ahí, AlloyDB Omni usa el umbral de bloque no válido definido por refresh_threshold_percentage
para determinar cuándo actualizar los datos de la tabla.
Si el valor de esta marca se establece en 0
, AlloyDB Omni ignora los análisis de tablas para determinar cuándo actualizar los datos de columna y, en su lugar, solo usa refresh_threshold_percentage
.
Actualización automática: periódica y adaptativa
google_columnar_engine.adaptive_auto_refresh_schedule
Tipo | String |
Predeterminado | Una string 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'
Reemplaza lo siguiente:
NUMBER: Es un número entero positivo.
TIME_UNITS: por
DAYS
oHOURS
.
Si no se define, AlloyDB Omni ejecuta el proceso de actualización automática adaptativa una vez por hora.
google_columnar_engine. min_adaptive_auto_refresh_blocks
Tipo | Integer |
Valores válidos | 0 ... 2147483647 |
Predeterminado | 50 |
Reinicios de instancias | No |
La cantidad de bloques de datos subyacentes de la unidad de columnas que se volvieron no 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 basa la tabla de columnas.
Combinación vectorizada
google_columnar_engine.enable_vectorized_join
Tipo | Boolean |
Predeterminado | off |
Reinicia la instancia | No |
Si es on
, AlloyDB Omni usa automáticamente operaciones vectorizadas de varios subprocesos para mejorar el rendimiento de las consultas que unen varias tablas.
Para obtener más información, consulta Habilita las uniones vectorizadas.
google_columnar_engine.vectorized_join_threads
Tipo | Integer |
Valores válidos | Hasta la mitad de la cantidad de CPU virtuales de la instancia |
Predeterminado | 1 |
Reinicia la instancia | No |
Define la cantidad máxima de subprocesos paralelos disponibles para el operador de unión vectorizada, habilitado por la marca enable_vectorized_join
.
Puedes definir un valor de hasta la mitad de las CPU virtuales de la instancia. Por ejemplo, en una instancia de 16 vCPU, el valor máximo de esta marca es 8
.
Funciones de versión preliminar
google_columnar_engine.enable_json_support
Tipo | Boolean |
Predeterminado | off |
Reinicia la instancia | No |
Si esta marca y enable_raw_format
se establecen en on
, AlloDB Omni permite 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 esta marca y enable_json_support
se establecen en on
,
AlloyDB Omni permite los tipos de datos JSON y JSONB de PostgreSQL en el almacén de columnas.