Exécuter AlloyDB Omni et s'y connecter à l'aide de RPM

Sélectionnez une version de la documentation :

Cette page explique comment exécuter AlloyDB Omni et s'y connecter après l'avoir installé sur votre propre machine.

Avant de commencer

Installez AlloyDB Omni sur votre système.

Exécuter AlloyDB Omni

Utilisez les informations des sections suivantes pour démarrer, vérifier l'état et arrêter AlloyDB Omni.

Facultatif : Mettre à jour les règles SELinux

Si SELinux est activé sur votre système et que vous modifiez certains paramètres GUC (Grand Unified Configuration) dans le fichier postgresql.conf, vous devez mettre à jour vos règles SELinux avant de démarrer le service AlloyDB Omni. La mise à jour de ces règles empêche les refus d'accès aux ressources qui peuvent rendre le serveur de base de données indisponible ou perturber des opérations telles que les sauvegardes.

L'exécution des commandes semanage et restorecon nécessite le package policycoreutils-python-utils.

Le tableau suivant liste les paramètres GUC qui nécessitent des mises à jour de la stratégie SELinux lorsque vous modifiez leurs valeurs par défaut :

Paramètre GUC Type de ressource Impact si la règle SELinux n'est pas mise à jour Solution
port Port Le serveur de base de données ne démarre pas et devient indisponible. Attribuez l'étiquette postgresql_port_t au port TCP personnalisé.
external_pid_file Fichier Le serveur de base de données reste disponible, mais SELinux refuse l'accès pour créer le fichier PID externe en dehors de /var/run/postgresql/. Attribuez l'étiquette postgresql_db_t au répertoire de fichiers PID personnalisé.
unix_socket_directories Fichier Le serveur de base de données ne parvient pas à créer le fichier de socket et devient indisponible. Attribuez l'étiquette postgresql_db_t au répertoire de sockets Unix personnalisé.
log_directory Fichier Le serveur de base de données ne parvient pas à écrire les journaux et devient indisponible. Attribuez l'étiquette postgresql_db_t au répertoire de journaux personnalisé.
archive_command Fichier Le serveur de base de données reste disponible, mais SELinux refuse l'accès en écriture au répertoire cible, ce qui peut perturber l'archivage et les sauvegardes des journaux WAL. Attribuez l'étiquette postgresql_db_t au répertoire d'archive personnalisé.

Mettre à jour la règle SELinux pour un port personnalisé

Si vous modifiez le paramètre port dans le fichier postgresql.conf, exécutez les commandes suivantes pour permettre à AlloyDB Omni de se lier au port TCP personnalisé :

  1. Ajoutez l'étiquette postgresql_port_t au port personnalisé :

    sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER

    Remplacez PORT_NUMBER par le numéro de port TCP personnalisé (par exemple, 5433).

  2. Vérifiez que la règle de port est mise à jour :

    sudo /usr/sbin/semanage port -l | grep postgresql_port_t

Mettre à jour la règle SELinux pour un répertoire personnalisé

Si vous modifiez le paramètre external_pid_file, unix_socket_directories, log_directory ou archive_command dans le fichier postgresql.conf pour utiliser un répertoire personnalisé, exécutez les commandes suivantes pour appliquer le contexte postgresql_db_t à ce répertoire :

sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DIRECTORY_PATH(/.*)?"
sudo /sbin/restorecon -R -F DIRECTORY_PATH

Remplacez DIRECTORY_PATH par le chemin d'accès complet au répertoire du fichier PID personnalisé, au répertoire du socket Unix, au répertoire des journaux ou au répertoire d'archive WAL.

Démarrer AlloyDB Omni

  sudo systemctl start alloydbomni18

Facultatif : Activer le redémarrage automatique du service

Pour activer le redémarrage automatique du service AlloyDB Omni, procédez comme suit :

  1. Ajoutez la configuration suivante au fichier /etc/systemd/system/alloydbomni18.service.d/override.conf.

      [Service]
    Restart=on-failure

  2. Rechargez la configuration du gestionnaire systemd et redémarrez le service alloydbomni18 pour que les modifications prennent effet.

    sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

Vérifier l'état d'AlloyDB Omni

   sudo systemctl status alloydbomni18

Arrêter AlloyDB Omni

  sudo systemctl stop alloydbomni18

Se connecter à AlloyDB Omni

Le package RPM AlloyDB Omni inclut également le client psql, qui vous permet d'ouvrir une session shell SQL interactive avec le serveur de base de données.

Vous pouvez également vous connecter à AlloyDB Omni à l'aide du logiciel compatible avec PostgreSQL de votre choix.

Se connecter à l'aide du client psql intégré

  /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

Cette commande vous connecte au serveur en tant qu'utilisateur postgres et affiche une invite de commande postgres=#. Vous pouvez maintenant exécuter des commandes psql et des requêtes SQL.

Pour quitter psql, exécutez la commande \q.

Se connecter à l'aide de vos propres applications

Toute application cliente compatible avec PostgreSQL peut également fonctionner avec AlloyDB Omni, sans aucune modification.

Utilisez n'importe quel client ou bibliothèque de code compatible avec PostgreSQL pour vous connecter à AlloyDB Omni.

Une fois connecté au serveur de base de données, vous pouvez définir, interroger et modifier vos bases de données en envoyant des requêtes LMD et des requêtes SQL via des protocoles de communication PostgreSQL standards.

Comme AlloyDB Omni s'exécute dans votre propre environnement, vous pouvez contrôler la façon dont vous vous connectez à AlloyDB Omni. Vous pouvez autoriser ou restreindre l'accès réseau à AlloyDB Omni en fonction des besoins de votre application, comme vous le feriez avec un serveur PostgreSQL ordinaire.

Étapes suivantes