En esta página se describe cómo ejecutar y conectarse a AlloyDB Omni después de instalarlo en tu máquina.
Antes de empezar
La mayoría de los comandos de esta página usan la CLI de AlloyDB Omni.
Para instalar esta herramienta de línea de comandos en tu máquina, consulta Instalar la CLI de AlloyDB Omni.
Ejecutar AlloyDB Omni
Los procedimientos que uses para ejecutar AlloyDB Omni dependen de si lo haces en un contenedor de un solo servidor.
Al instalar AlloyDB Omni, se configura un servicio del sistema llamado alloydb-dataplane que se inicia cada vez que se arranca tu máquina.
Para controlar y monitorizar AlloyDB Omni de forma básica, usa el comando sudo alloydb, tal como se muestra en las siguientes secciones.
Iniciar AlloyDB Omni
sudo alloydb database-server startPara realizar una conexión de prueba, consulta Conectarse mediante el contenedorpsql.
Comprobar el estado de AlloyDB Omni
sudo alloydb database-server statusDetener AlloyDB Omni
sudo alloydb database-server stopInhabilitar el inicio al arrancar
Si ejecutas el siguiente comando, AlloyDB Omni no se iniciará automáticamente cuando se arranque tu máquina.
sudo systemctl disable alloydb-dataplaneVolver a habilitar el inicio al arrancar
sudo systemctl enable alloydb-dataplaneConectarse a AlloyDB Omni que se ejecuta en un solo servidor
El contenedor de AlloyDB Omni incluye su propia copia de psql, que te permite abrir una sesión interactiva de shell de SQL con su servidor de base de datos.
También puedes conectarte a AlloyDB Omni desde fuera del contenedor mediante el software compatible con PostgreSQL que elijas.
Conectarse mediante el psql en contenedores
Para conectarte al servidor de bases de datos de AlloyDB Omni mediante su propia copia en contenedor de psql, ejecuta el siguiente comando:
Un solo servidor
docker exec -it pg-service psql -h localhost -U postgresEste comando te conecta al servidor con el rol de usuario postgres y muestra un postgres=#. Ahora puedes ejecutar comandos de psql y consultas SQL.
Para salir de psql, ejecuta el comando \q.
Conectarse usando tus propias aplicaciones
Cualquier aplicación que funcione con PostgreSQL también puede funcionar con AlloyDB Omni sin necesidad de hacer modificaciones.
Para conectarte al servidor de bases de datos de AlloyDB Omni, usa cualquier cliente o biblioteca de código compatible con PostgreSQL para conectarte al puerto 5432 (el puerto predeterminado del servidor de bases de datos de PostgreSQL) de la máquina que ejecuta AlloyDB Omni.
Esto funciona porque el contenedor de AlloyDB Omni expone su propio puerto
5432 al mismo puerto de la máquina en la que se ejecuta.
Después de conectarte al servidor de bases de datos, puedes definir, consultar y modificar tus bases de datos mediante consultas DML y SQL con protocolos de comunicación de PostgreSQL estándar.
Como AlloyDB Omni se ejecuta en tu propio entorno, puedes controlar cómo te conectas a él. Esto incluye permitir o restringir el acceso a la red de este servicio según las necesidades de tu aplicación, al igual que harías con un servidor PostgreSQL normal.