Configurer le moteur de données en colonnes dans AlloyDB Omni

Sélectionnez une version de la documentation :

Cette page explique comment activer ou désactiver le moteur de données en colonnes sur un cluster de bases de données AlloyDB Omni. Il explique également comment configurer une taille initiale appropriée pour son store orienté colonnes.

Pour utiliser le moteur de données en colonnes lorsque vous utilisez AlloyDB pour PostgreSQL sur Google Cloud, consultez Configurer le moteur de données en colonnes.

Pour une présentation conceptuelle du moteur de données en colonnes AlloyDB, consultez À propos du moteur de données en colonnes AlloyDB.

Activer le moteur de données en colonnes

Pour utiliser le moteur de données en colonnes sur une instance, définissez l'option google_columnar_engine.enabled de l'instance sur on.

Pour définir cette option sur une instance, procédez comme suit :

  1. Exécutez la commande PostgreSQL ALTER SYSTEM :

    ALTER SYSTEM SET google_columnar_engine.enabled = 'on'

  2. Si vous souhaitez ajuster la configuration du moteur de données en colonnes, suivez les instructions de la section suivante avant de redémarrer le serveur de base de données. Sinon, suivez les deux étapes suivantes pour redémarrer le serveur de base de données maintenant.

  3. Arrêtez le serveur de base de données.

  4. Démarrez le serveur de base de données.

Configurer la taille du store orienté colonnes

Lorsque le moteur de données en colonnes est activé sur une instance, AlloyDB alloue une partie de la mémoire de l'instance pour stocker ses données en colonnes. En dédiant de la RAM haut débit à votre store orienté colonnes, vous vous assurez qu'AlloyDB peut accéder aux données en colonnes le plus rapidement possible.

Vous pouvez également définir l'allocation sur une taille fixe et spécifique à l'aide de l'option google_columnar_engine.memory_size_in_mb.

Pour définir cette option sur une instance, procédez comme suit :

  1. Exécutez la commande PostgreSQL ALTER SYSTEM :

    ALTER SYSTEM SET google_columnar_engine.memory_size_in_mb = COLUMN_STORE_SIZE;

    Remplacez COLUMN_STORE_SIZE par la nouvelle taille du columnstore, en mégaoctets.

  2. Arrêtez le serveur de base de données.

  3. Démarrez le serveur de base de données.

Activer la jointure vectorisée

Le moteur de données en colonnes dispose d'une fonctionnalité de jointure vectorisée qui peut améliorer les performances des jointures en appliquant un traitement vectorisé aux requêtes éligibles.

Une fois la jointure vectorisée activée, le planificateur de requêtes AlloyDB peut appliquer l'opérateur de jointure vectorisée au lieu de l'opérateur de jointure de hachage PostgreSQL standard. Le planificateur prend cette décision en comparant le coût d'exécution de la requête à l'aide de l'une ou l'autre méthode.

Pour activer la jointure vectorisée sur une instance, définissez le flag google_columnar_engine.enable_vectorized_join de l'instance sur on.

Pour définir cette option sur une instance, exécutez la commande PostgreSQL ALTER SYSTEM :

ALTER SYSTEM SET google_columnar_engine.enable_vectorized_join = 'on';

AlloyDB alloue par défaut un thread à la fonctionnalité de jointure vectorisée. Vous pouvez augmenter le nombre de threads disponibles pour cette fonctionnalité en définissant l'option google_columnar_engine.vectorized_join_threads sur une valeur plus élevée.

Actualiser manuellement votre moteur de données en colonnes

Par défaut, le moteur de données en colonnes est configuré pour actualiser automatiquement le store orienté colonnes en arrière-plan lorsqu'il est activé. Dans certains cas, vous devrez peut-être actualiser manuellement le magasin de colonnes, par exemple si l'actualisation automatique n'actualise pas une relation comportant un nombre élevé de blocs non valides.

Pour actualiser manuellement le moteur de données en colonnes, exécutez la requête SQL suivante :

SELECT google_columnar_engine_refresh('TABLE_NAME');

Remplacez TABLE_NAME par le nom de la table ou de la vue matérialisée que vous souhaitez actualiser manuellement.

Désactiver le moteur de données en colonnes

Pour désactiver le moteur columbar sur une instance, définissez l'option google_columnar_engine.enabled sur off.

Pour définir cette option sur une instance, procédez comme suit :

  1. Exécutez la commande PostgreSQL ALTER SYSTEM :

    ALTER SYSTEM SET google_columnar_engine.enabled = 'off'

  2. Arrêtez le serveur de base de données.

  3. Démarrez le serveur de base de données.

Résoudre les problèmes liés au moteur de données en colonnes

Corriger une erreur "mémoire partagée insuffisante"

Si vous exécutez AlloyDB Omni sans disposer de suffisamment de mémoire partagée pour le moteur de données en colonnes, l'erreur suivante peut s'afficher :

Insufficient shared memory for generating the columnar formats.

Vous pouvez résoudre ce problème en spécifiant la quantité de mémoire partagée disponible pour le conteneur AlloyDB Omni. La méthode à suivre dépend de votre système d'exploitation hôte.

Linux

Augmentez la taille de la partition /dev/shm de votre machine hôte, par exemple en modifiant votre fichier /etc/fstab.

macOS

Installez un nouveau conteneur AlloyDB Omni en spécifiant une valeur de mémoire partagée plus élevée pour l'option --shm-size.

Résoudre les problèmes de colonnes non renseignées

Si les colonnes ne sont pas renseignées dans le moteur de données en colonnes, l'une des situations suivantes peut se produire :

  • Les colonnes que vous souhaitez ajouter incluent un type de données non compatible.

  • Les exigences du moteur de données en colonnes ne sont pas respectées.

Pour identifier la cause de ce problème, essayez les solutions suivantes :

  • Vérifiez que les tables ou les vues matérialisées de notre requête se trouvent dans le moteur de données en colonnes.

  • Vérifiez l'utilisation du moteur de données en colonnes à l'aide de l'instruction EXPLAIN.

Étapes suivantes