Exécuter AlloyDB Omni et s'y connecter

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.

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).

Démarrer AlloyDB Omni

Pour démarrer un conteneur AlloyDB Omni arrêté, exécutez la commande docker container start ou la commande podman container start :

Docker 

docker container start CONTAINER_NAME

Remplacez CONTAINER_NAME par le nom que vous avez attribué au conteneur AlloyDB Omni lors de son installation.

Podman 

podman container start CONTAINER_NAME

Remplacez CONTAINER_NAME par le nom que vous avez attribué au conteneur AlloyDB Omni lors de son installation.

Vérifier l'état d'AlloyDB Omni

Pour vérifier l'état de tous les conteneurs en cours d'exécution, exécutez la commande docker container ls ou la commande podman container ls :

Docker 

docker container ls

Podman 

podman container ls

Si votre conteneur AlloyDB Omni est en cours d'exécution, son nom apparaît dans la colonne NAMES du tableau de sortie. La ligne correspondante résume l'état du conteneur.

Si le nom de votre conteneur n'apparaît pas dans la colonne NAMES, cela signifie que votre AlloyDB Omni n'est pas en cours d'exécution.

Arrêter AlloyDB Omni

Pour arrêter un conteneur AlloyDB Omni, exécutez la commande docker container stop ou la commande podman container stop :

Docker 

  docker container stop CONTAINER_NAME

Remplacez CONTAINER_NAME par le nom que vous avez attribué au conteneur AlloyDB Omni lors de son installation.

Podman 

  podman container stop CONTAINER_NAME

Remplacez CONTAINER_NAME par le nom que vous avez attribué au conteneur AlloyDB Omni lors de son installation.

Se 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.

Pour savoir comment vous connecter à un cluster de bases de données AlloyDB Omni exécuté sur un cluster Kubernetes, consultez Se connecter à AlloyDB Omni exécuté sur Kubernetes.

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 :

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

Remplacez CONTAINER_NAME par le nom que vous avez attribué au conteneur AlloyDB Omni lors de son installation.

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

Remplacez CONTAINER_NAME par le nom que vous avez attribué au conteneur AlloyDB Omni lors de son installation.

Cette 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, exposez le réseau du conteneur Docker AlloyDB Omni à votre machine hôte en ajoutant --network=host ou -p 5432:5432 à votre commande docker run ou podman run lorsque vous démarrez AlloyDB Omni.

Pour sélectionner un numéro de port personnalisé, utilisez -p [HOST_PORT]:5432 lorsque vous démarrez AlloyDB Omni. Ensuite, utilisez n'importe quel client ou bibliothèque de code compatible avec PostgreSQL pour vous connecter au port 5432 ou au numéro de port personnalisé que vous avez spécifié.

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.

Étapes suivantes