Cette page explique comment exécuter AlloyDB Omni et s'y connecter après l'avoir installé sur votre propre machine.
Avant de commencer
La plupart des commandes de cette page utilisent l'interface de ligne de commande AlloyDB Omni.
Pour installer cet outil de ligne de commande sur votre machine, consultez Installer la CLI AlloyDB Omni.
Exécuter AlloyDB Omni
Les procédures que vous utilisez pour exécuter AlloyDB Omni dépendent de l'environnement dans lequel vous exécutez AlloyDB Omni (dans un conteneur sur un seul serveur, par exemple).
L'installation d'AlloyDB Omni configure un service système appelé alloydb-dataplane, qui est configuré pour se lancer à chaque démarrage de votre machine.
Pour contrôler et surveiller de base AlloyDB Omni, utilisez la commande sudo alloydb, comme indiqué dans les sections suivantes.
Démarrer AlloyDB Omni
sudo alloydb database-server startPour effectuer un test de connexion, consultez Se connecter à l'aide de psql conteneurisé.
Vérifier l'état d'AlloyDB Omni
sudo alloydb database-server statusArrêter AlloyDB Omni
sudo alloydb database-server stopDésactiver le lancement au démarrage
L'exécution de la commande suivante empêche AlloyDB Omni de démarrer automatiquement au démarrage de votre machine.
sudo systemctl disable alloydb-dataplaneRéactiver le lancement au démarrage
sudo systemctl enable alloydb-dataplaneSe connecter à AlloyDB Omni exécuté sur un seul serveur
Le conteneur AlloyDB Omni inclut sa propre copie de psql, qui vous permet d'ouvrir une session de shell SQL interactif avec son serveur de base de données.
Vous pouvez également vous connecter à AlloyDB Omni depuis l'extérieur du conteneur, à l'aide du logiciel compatible avec PostgreSQL de votre choix.
Se connecter à l'aide de psql conteneurisé
Pour vous connecter au serveur de base de données AlloyDB Omni à l'aide de sa propre copie conteneurisée de psql, exécutez la commande suivante :
Serveur unique
docker exec -it pg-service psql -h localhost -U postgresCette commande vous connecte au serveur en tant que rôle utilisateur postgres et affiche une invite de commande postgres=#. Vous pouvez désormais 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 fonctionnant avec PostgreSQL peut également fonctionner avec AlloyDB Omni, sans aucune modification.
Pour vous connecter au serveur de base de données AlloyDB Omni, utilisez n'importe quel client ou bibliothèque de code compatible avec PostgreSQL pour vous connecter au port 5432 (port par défaut du serveur de base de données PostgreSQL) de la machine exécutant AlloyDB Omni.
Cela fonctionne, car le conteneur AlloyDB Omni expose son propre port 5432 au même port de la machine sur laquelle il s'exécute.
Une fois connecté au serveur de base de données, vous pouvez définir, interroger et modifier vos bases de données à l'aide de requêtes LMD et SQL en utilisant les 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. Cela inclut l'autorisation ou la restriction de l'accès réseau à ce service en fonction des besoins de votre application, comme vous le feriez avec un serveur PostgreSQL ordinaire.