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 données en colonnes. Pour obtenir la liste de toutes les options de base de données compatibles avec AlloyDB Omni, consultez Options de base de données compatibles.
Pour les options marquées avec Redémarrage de l'instance, vous devez redémarrer l'instance AlloyDB Omni chaque fois que vous définissez, supprimez ou modifiez l'option concernée 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émarrage de l'instance | Oui |
Si la valeur est on, le moteur de données en colonnes AlloyDB Omni est activé.
Organisation automatique des données en colonnes
google_columnar_engine.enable_auto_columnarization
| Type | Boolean |
| Par défaut | on |
| Redémarrage de l'instance | Non |
Si la valeur est on, les fonctionnalités d'organisation automatique des données en colonnes du moteur de données en colonnes sont activées.
google_columnar_engine.relations
| Type | String |
| Par défaut | Chaîne vide |
| Redémarrage de l'instance | Non |
Spécifie une liste de colonnes qu'AlloyDB Omni doit ajouter au store orienté colonnes de votre cluster, en complément du processus d'organisation automatique des données en colonnes. Ces colonnes peuvent provenir de n'importe quelle table de votre cluster.
La valeur de l'option prend le format 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 store orienté colonnes.
google_columnar_engine.auto_columnarization_schedule
| Type | String |
| Par défaut | Chaîne vide |
| Redémarrage de l'instance | Non |
| Valeur maximale autorisée | 2147483647 |
Spécifie la fréquence à laquelle AlloyDB Omni exécute son processus d'organisation automatique des données en colonnes sur l'instance.
La valeur est une chaîne au format suivant :
'EVERY NUMBER TIME_UNITS'
Remplacez les éléments suivants :
NUMBER : entier positif
TIME_UNITS :
DAYSouHOURS
Si ce paramètre n'est pas défini, AlloyDB Omni exécute le processus d'organisation automatique des données en colonnes 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émarrage de l'instance | Oui |
Quantité de mémoire d'instance, exprimée en mébioctets (Mio), qu'AlloyDB Omni alloue au store orienté colonnes.
Si cette option n'est pas définie, 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émarrage de l'instance | 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 cette option est définie sur off alors que l'option google_columnar_engine.enabled est définie sur on, le moteur de données en colonnes reste activé et conserve son store orienté colonnes, mais AlloyDB Omni n'utilise pas de données en colonnes lorsqu'il traite les requêtes.
google_columnar_engine.omni_storage_cache_directory
Cette option vous permet de spécifier un chemin d'accès vers un répertoire dédié distinct pour les fichiers de cache de disque du moteur en colonnes.
| Type | String |
| Valeurs valides | Chemin d'accès unique au répertoire dans lequel les fichiers de cache du disque sont stockés. |
| Par défaut | La taille totale de la revendication de volume persistant (PVC, Persistent Volume Claim) dédiée est allouée au cache de déversement sur disque en colonnes. |
| Redémarrage de l'instance | 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 l'option de taille du cache de stockage.
| Type | Integer |
| Valeurs valides | 1024 ... 2147483647 |
| Par défaut | 5 % du cache de disque sont alloués au moteur de données en colonnes lorsque google_columnar_engine.omni_storage_cache_directory n'est pas spécifié. |
| Redémarrage de l'instance | Oui |
Si la valeur est on, AlloyDB Omni configure la taille du cache de stockage pour le moteur de données en colonnes.
Lorsque google_columnar_engine.omni_storage_cache_directory n'est pas spécifié, la valeur maximale autorisée pour cette option est de 50 % du cache de 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émarrage de l'instance | 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émarrage de l'instance | 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émarrage de l'instance | 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 (un 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'option
refresh_threshold_scan_countdistincte.Le pourcentage de blocs de données sous-jacents de l'unité de colonne qui sont devenus non valides dépasse la valeur de l'option
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 des 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émarrage de l'instance | 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 de l'option refresh_threshold_scan_count spécifie la valeur minimale que doit atteindre 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 | Chaîne vide |
| Redémarrage de l'instance | 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 : entier positif
TIME_UNITS :
DAYSouHOURS
Si cette valeur 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émarrage de l'instance | Non |
Le nombre de blocs de données sous-jacents de l'unité de colonne qui sont devenus non valides dépasse la valeur de l'option 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 des 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émarrage de 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émarrage de l'instance | No |
Définit le nombre maximal de threads parallèles disponibles pour l'opérateur de jointure vectorisée, activé par l'option 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 cette option est 8.
Fonctionnalités en preview
google_columnar_engine.enable_json_support
| Type | Boolean |
| Par défaut | off |
| Redémarrage de l'instance | No |
Si cette option et enable_raw_format sont définis sur on, AlloyDB Omni autorise les types de données JSON et JSONB PostgreSQL dans le store orienté colonnes.
google_columnar_engine.enable_raw_format
| Type | Boolean |
| Par défaut | off |
| Redémarrage de l'instance | No |
Si cette option et enable_json_support sont définis sur on, AlloyDB Omni autorise les types de données JSON et JSONB PostgreSQL dans le store orienté colonnes.