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 bases de datos de AlloyDB Omni.
Habilitación
google_columnar_engine.enabled
| Tipo | Boolean |
| Predeterminado | off |
| Se reiniciaron las 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 |
| Se reiniciaron las instancias | No |
Si es on, habilita las funciones de columnarización automática del motor de columnas.
google_columnar_engine.relations
| Tipo | String |
| Predeterminado | Una string vacía |
| Se reiniciaron las 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 columnarización automática. 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 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 |
| Se reiniciaron las instancias | No |
| Valor máximo permitido | 2147483647 |
Especifica la frecuencia con la que AlloyDB Omni ejecuta su proceso de auto-columnarizació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
DAYSoHOURS.
Si no se define, AlloyDB Omni ejecuta el proceso de autocolumnarización 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 |
| Se reiniciaron las instancias | Sí |
La cantidad de memoria de instancia, expresada en mebibytes (MiB), que AlloyDB Omni asigna al almacén de columnas.
Si no se configura 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 |
| Se reiniciaron las 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 columnar permanece habilitado y conserva su almacén de columnas, pero AlloyDB Omni no usa datos columnares cuando controla las consultas.
google_columnar_engine.omni_storage_cache_directory
Esta marca te permite especificar una ruta de acceso de directorio dedicada independiente para los archivos de caché de disco del motor columnar.
| Tipo | String |
| Valores válidos | Es la ruta de acceso a un solo directorio en el que se almacenan los archivos de la caché de 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. |
| Se reiniciaron las 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 caché de disco.
| Tipo | Integer |
| Valores válidos | 1024 ... 2147483647 |
| Predeterminado | El 5% de la caché de disco se asigna al motor columnar cuando no se especifica google_columnar_engine.omni_storage_cache_directory. |
| Se reiniciaron las 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 caché de 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 |
| Se reiniciaron las instancias | No |
Es 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 |
| Se reiniciaron las instancias | No |
Es la cantidad máxima de trabajadores paralelos 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 |
| Se reiniciaron las instancias | No |
Especifica el umbral de actualización de datos del almacén de columnas, expresado como un porcentaje.
AlloyDB Omni actualiza los datos dentro de una unidad columnar (un conjunto de bloques de datos dentro de una tabla columnar) 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 columnar que se volvieron no válidos supera el valor de la marca
refresh_threshold_percentage. 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.
google_columnar_engine.refresh_threshold_scan_count
| Tipo | Integer |
| Valores válidos | 0 ... 2147483647 |
| Predeterminado | 5 |
| Se reiniciaron las 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 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 se establece en 0, AlloyDB Omni ignora los análisis de tablas para determinar cuándo actualizar los datos en 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 string vacía |
| Se reiniciaron las 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 adaptativa una vez por hora.
google_columnar_engine. min_adaptive_auto_refresh_blocks
| Tipo | Integer |
| Valores válidos | 0 ... 2147483647 |
| Predeterminado | 50 |
| Se reiniciaron las instancias | No |
La cantidad de bloques de datos subyacentes de la unidad columnar que se volvieron no válidos 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 subprocesos múltiples 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 del recuento 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.