En esta página, se describen las marcas de base de datos que usa AlloyDB Omni para habilitar y administrar funciones específicas de su motor columnar. Para obtener una lista de todas las marcas de bases de datos que admite AlloyDB Omni, consulta Marcas de bases de datos compatibles.
Las marcas marcadas con Reinicios 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 lo vuelvas a modificar.
Para obtener instrucciones sobre cómo configurar 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.
Estructuración automática en columnas
google_columnar_engine.enable_auto_columnarization
| Tipo | Boolean |
| Predeterminado | on |
| Reinicios de instancias | No |
Si es on, habilita las funciones de estructuración automática en columnas
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 estructuración automática en columnas. Estas columnas pueden provenir de cualquier tabla dentro de tu clúster.
El valor de la marca se formatea como 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 Administra 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 estructuración automática en columnas 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
DAYSoHOURS.
Si no se define, AlloyDB Omni ejecuta el proceso de estructuración automática en 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 instancia |
| Reinicios de instancias | Sí |
La cantidad de memoria de instancia, expresada en mebibytes (MiB), que AlloyDB 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 en columnas cuando controla las consultas.
google_columnar_engine.omni_storage_cache_directory
Esta marca te permite especificar una ruta de acceso a un directorio dedicado independiente para los archivos de memoria caché del disco del motor de columnas.
| Tipo | String |
| Valores válidos | Es una ruta de acceso de directorio única en la que se almacenan los archivos de la memoria caché del disco. |
| Predeterminado | El tamaño total de la reclamación de volumen persistente (PVC) dedicada se asigna a la caché columnar de transferencia a disco. |
| Reinicios de instancias | Sí |
google_columnar_engine.storage_cache_size
Si no se especifica google_columnar_engine.omni_storage_cache_directory, para habilitar el tamaño de la caché de almacenamiento, debes habilitar la memoria caché del disco.
| Tipo | Integer |
| Valores válidos | 1024 ... 2147483647 |
| Predeterminado | El 5% de la memoria caché del disco se asigna al motor de columnas cuando no se especifica google_columnar_engine.omni_storage_cache_directory. |
| 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.
Cuando no se especifica google_columnar_engine.omni_storage_cache_directory, el valor máximo permitido para esta marca es el 50% de la memoria caché del disco total. También se aplica el límite de 1,000 * google_columnar_engine.memory_size_in_mb.
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 |
Es la cantidad máxima de trabajadores paralelos que el motor de columnas puede crear para administrar 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 columnas, un conjunto de bloques de datos dentro de una tabla de columnas, cuando se cumplen las siguientes condiciones:
La tabla de la unidad columnar superó el umbral de análisis definido por la marca
refresh_threshold_scan_countseparada.El porcentaje de los bloques de datos subyacentes de la unidad de columnas que se volvieron no válidos supera el valor de la marca
refresh_threshold_percentage. Los bloques de datos en columnas dejan de ser válidos debido a cambios en los datos basados en filas en los que se basa la tabla en 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 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 se establece en 0, AlloyDB Omni
ignora los análisis de tablas para determinar cuándo actualizar los datos de columnas y, en su lugar, solo usa
refresh_threshold_percentage.
Actualización automática: periódica y adaptable
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
DAYSoHOURS.
Si no se define, AlloyDB Omni ejecuta el proceso de actualización automática adaptable 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 |
La cantidad de bloques de datos subyacentes de la unidad de columnas que se
invalidaron supera el valor de la marca
min_adaptive_auto_refresh_blocks. Los bloques de datos columnares dejan de ser válidos debido a los cambios en los datos basados en filas de los que se basa la tabla columnar.
Unió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 CPUs virtuales, 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, 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 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.