Cette page décrit les options de base de données qu'AlloyDB Omni utilise pour activer et gérer les fonctionnalités spécifiques à son moteur de colonnes. Pour obtenir la liste de tous les indicateurs de base de données compatibles avec AlloyDB Omni, consultez Indicateurs de base de données compatibles.
Les options marquées par Redémarrage de l'instance signifient que vous devez redémarrer une instance AlloyDB Omni chaque fois que vous définissez, supprimez ou modifiez cette option sur cette instance. La valeur de l'option persiste pour l'instance jusqu'à ce que vous la modifiiez à nouveau.
Pour savoir comment définir une option de base de données, consultez Configurer des options de base de données AlloyDB Omni.
Activation
google_columnar_engine.enabled
| Type | Boolean |
| Par défaut | off |
| Redémarrages d'instances | Oui |
Si la valeur est on, le moteur columnar AlloyDB Omni est activé.
Organisation automatique des données en colonnes
google_columnar_engine.enable_auto_columnarization
| Type | Boolean |
| Par défaut | on |
| Redémarrages d'instances | Non |
Si la valeur est on, les fonctionnalités d'auto-columnarisation du moteur de données en colonnes sont activées.
google_columnar_engine.relations
| Type | String |
| Par défaut | Une chaîne vide |
| Redémarrages d'instances | Non |
Spécifie une liste de colonnes qu'AlloyDB Omni doit ajouter au column store de votre cluster, en plus du processus de columnarisation automatique. Ces colonnes peuvent provenir de n'importe quelle table de votre cluster.
La valeur du flag est mise en forme sous la forme d'une liste d'éléments séparés par une virgule. Chaque élément spécifie une ou plusieurs colonnes d'une même table, au format suivant :
'DATABASE_NAME.SCHEMA_NAME.TABLE_NAME(COLUMN_LIST)'
Pour en savoir plus, consultez Gérer manuellement le contenu du column store.
google_columnar_engine.auto_columnarization_schedule
| Type | String |
| Par défaut | Une chaîne vide |
| Redémarrages d'instances | Non |
| Valeur maximale autorisée | 2147483647 |
Spécifie la fréquence à laquelle AlloyDB Omni exécute son processus d'auto-columnarisation sur l'instance.
La valeur est une chaîne au format suivant :
'EVERY NUMBER TIME_UNITS'
Remplacez les éléments suivants :
NUMBER : un nombre entier positif.
TIME_UNITS :
DAYSouHOURS.
Si elle n'est pas définie, AlloyDB Omni exécute le processus d'auto-columnarisation une fois par heure.
Dimensionnement et traitement des requêtes
google_columnar_engine.memory_size_in_mb
| Type | Integer |
| Valeurs valides | Entre 128 et la valeur représentant 70 % de la mémoire de l'instance |
| Par défaut | 1 Go de mémoire d'instance |
| Redémarrages d'instances | Oui |
Quantité de mémoire d'instance, exprimée en mébioctets (Mio), qu'AlloyDB Omni alloue au store orienté colonnes.
Si cet indicateur n'est pas défini, AlloyDB Omni alloue 1 Go de la mémoire de l'instance au store orienté colonnes.
google_columnar_engine.enable_columnar_scan
| Type | Boolean |
| Par défaut | on |
| Redémarrages d'instances | Non |
Si la valeur est on, AlloyDB Omni peut accéder aux données du store orienté colonnes lors du traitement des requêtes.
Si cet indicateur est défini sur off alors que google_columnar_engine.enabled est défini sur on, le moteur columnar reste activé et conserve son magasin de colonnes, mais AlloyDB Omni n'utilise pas les données columnaires lorsqu'il traite les requêtes.
google_columnar_engine.omni_storage_cache_directory
Cet indicateur vous permet de spécifier un chemin d'accès à un répertoire dédié distinct pour les fichiers de cache de disque du moteur de colonnes.
| Type | String |
| Valeurs valides | Chemin d'accès unique au répertoire dans lequel les fichiers du cache disque sont stockés. |
| Par défaut | La taille totale de la PersistentVolumeClaim (PVC) dédiée est allouée au cache de déversement sur disque en colonnes. |
| Redémarrages d'instances | Oui |
google_columnar_engine.storage_cache_size
Si google_columnar_engine.omni_storage_cache_directory n'est pas spécifié, vous devez activer le cache de disque pour activer la taille du cache de stockage.
| Type | Integer |
| Valeurs valides | 1024 ... 2147483647 |
| Par défaut | 5 % du cache de disque sont alloués au moteur en colonnes lorsque google_columnar_engine.omni_storage_cache_directory n'est pas spécifié. |
| Redémarrages d'instances | Oui |
Si la valeur est on, AlloyDB Omni configure la taille du cache de stockage pour le moteur en colonnes.
Lorsque google_columnar_engine.omni_storage_cache_directory n'est pas spécifié, la valeur maximale autorisée pour cet indicateur est de 50 % du cache disque total. Le plafond de 1 000 google_columnar_engine.memory_size_in_mb s'applique également.
Activités de maintenance
google_job_scheduler.maintenance_cpu_percentage
| Type | Integer |
| Valeurs valides | 0 ... 100 |
| Par défaut | 20 |
| Redémarrages d'instances | Non |
Pourcentage maximal de la capacité de processeur d'une instance que le moteur de données en colonnes peut appliquer au traitement en arrière-plan.
google_job_scheduler.max_parallel_workers_per_job
| Type | Integer |
| Valeurs valides | 0 ... 262143 |
| Par défaut | 2 |
| Redémarrages d'instances | Non |
Nombre maximal de nœuds de calcul parallèles que le moteur de données en colonnes peut créer pour gérer une opération de traitement en arrière-plan
Actualisation automatique basée sur les événements
google_columnar_engine.refresh_threshold_percentage
| Type | Integer |
| Valeurs valides | 1 ... 100 |
| Par défaut | 50 |
| Redémarrages d'instances | Non |
Spécifie le seuil d'actualisation des données du store orienté colonnes, sous forme de pourcentage.
AlloyDB Omni actualise les données d'une unité de colonne (ensemble de blocs de données dans une table en colonnes) lorsque les conditions suivantes sont remplies :
La table de l'unité de colonne a dépassé le seuil d'analyse défini par l'indicateur
refresh_threshold_scan_countdistinct.Le pourcentage de blocs de données sous-jacents de l'unité de colonne qui sont devenus non valides dépasse la valeur du flag
refresh_threshold_percentage. Les blocs de données en colonnes deviennent non valides en raison de modifications apportées aux données basées sur les lignes sur lesquelles s'appuie la table en colonnes.
google_columnar_engine.refresh_threshold_scan_count
| Type | Integer |
| Valeurs valides | 0 ... 2147483647 |
| Par défaut | 5 |
| Redémarrages d'instances | Non |
AlloyDB Omni comptabilise les analyses de table effectuées sur chaque table de données en colonnes depuis la dernière requête LMD effectuée sur la table concernée. La valeur du flag refresh_threshold_scan_count spécifie la valeur minimale de ce compteur dans n'importe quelle table en colonnes avant qu'AlloyDB Omni puisse actualiser ses données. À partir de là, AlloyDB Omni utilise le seuil de blocs non valides défini par refresh_threshold_percentage pour déterminer quand actualiser les données de la table.
Si la valeur de cette option est définie sur 0, AlloyDB Omni ignore les analyses de table pour déterminer quand actualiser les données en colonnes, et utilise uniquement refresh_threshold_percentage.
Actualisation automatique : périodique et adaptative
google_columnar_engine.adaptive_auto_refresh_schedule
| Type | String |
| Par défaut | Une chaîne vide |
| Redémarrages d'instances | Non |
| Valeur maximale autorisée | 2147483647 |
Indique la fréquence à laquelle AlloyDB Omni exécute son processus d'actualisation automatique adaptative sur l'instance.
La valeur est une chaîne au format suivant :
'EVERY NUMBER TIME_UNITS'
Remplacez les éléments suivants :
NUMBER : un nombre entier positif.
TIME_UNITS :
DAYSouHOURS.
Si elle n'est pas définie, AlloyDB Omni exécute le processus d'actualisation automatique adaptative une fois par heure.
google_columnar_engine. min_adaptive_auto_refresh_blocks
| Type | Integer |
| Valeurs valides | 0 ... 2147483647 |
| Par défaut | 50 |
| Redémarrages d'instances | Non |
Le nombre de blocs de données sous-jacents de l'unité de colonne qui sont devenus non valides dépasse la valeur du flag min_adaptive_auto_refresh_blocks. Les blocs de données en colonnes deviennent non valides en raison de modifications apportées aux données basées sur les lignes sur lesquelles s'appuie la table en colonnes.
Jointure vectorisée
google_columnar_engine.enable_vectorized_join
| Type | Boolean |
| Par défaut | off |
| Redémarrer l'instance | No |
Si la valeur est on, AlloyDB Omni utilise automatiquement des opérations vectorisées multithread pour améliorer les performances des requêtes qui joignent plusieurs tables.
Pour en savoir plus, consultez Activer les jointures vectorisées.
google_columnar_engine.vectorized_join_threads
| Type | Integer |
| Valeurs valides | Jusqu'à la moitié du nombre de vCPU de l'instance |
| Par défaut | 1 |
| Redémarrer l'instance | No |
Définit le nombre maximal de threads parallèles disponibles pour l'opérateur de jointure vectorisée, activé par le flag enable_vectorized_join.
Vous pouvez définir une valeur égale à la moitié des processeurs virtuels de l'instance. Par exemple, sur une instance à 16 vCPU, la valeur maximale de cet indicateur est 8.
Fonctionnalités en preview
google_columnar_engine.enable_json_support
| Type | Boolean |
| Par défaut | off |
| Redémarrer l'instance | No |
Si cet indicateur et enable_raw_format sont définis sur on, AlloyDB Omni autorise les types de données JSON et JSONB PostgreSQL dans le column store.
google_columnar_engine.enable_raw_format
| Type | Boolean |
| Par défaut | off |
| Redémarrer l'instance | No |
Si cet indicateur et enable_json_support sont définis sur on, AlloyDB Omni autorise les types de données JSON et JSONB PostgreSQL dans le column store.