Ejecuta y conéctate a AlloyDB Omni

Selecciona una versión de la documentación:

En esta página, se describe cómo ejecutar AlloyDB Omni y conectarte a él después de instalarlo en tu propia máquina.

Antes de comenzar

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 Instala la CLI de AlloyDB Omni.

Ejecuta AlloyDB Omni

Los procedimientos que usas para ejecutar AlloyDB Omni dependen de si lo ejecutas en un contenedor en un solo servidor.

Cuando instalas AlloyDB Omni, se configura un servicio del sistema llamado alloydb-dataplane que está configurado para iniciarse cada vez que se inicia tu máquina.

Para el control y la supervisión básicos de AlloyDB Omni, usa el comando sudo alloydb, como se muestra en las siguientes secciones.

Inicia AlloyDB Omni

sudo alloydb database-server start

Para realizar una conexión de prueba, consulta Conéctate con psql.

Verifica el estado de AlloyDB Omni

sudo alloydb database-server status

Detén AlloyDB Omni

sudo alloydb database-server stop

Inhabilita el inicio

Ejecutar el siguiente comando impide que AlloyDB Omni se inicie automáticamente cuando se inicia tu máquina.

sudo systemctl disable alloydb-dataplane

Vuelve a habilitar el inicio

  sudo systemctl enable alloydb-dataplane

Conéctate 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 con el software compatible con PostgreSQL que elijas.

Conéctate con psql en contenedores

Para conectarte al servidor de base de datos de AlloyDB Omni con su propia copia en contenedores de psql, ejecuta el siguiente comando:

Servidor único 

docker exec -it pg-service psql -h localhost -U postgres

Este comando te conecta al servidor como el rol de usuario postgres y muestra un postgres=# símbolo del sistema. Ahora puedes ejecutar psql comandos y SQL consultas.

Para salir de psql, ejecuta el comando \q.

Conéctate con tus propias aplicaciones

Cualquier aplicación que funcione con PostgreSQL también puede funcionar con AlloyDB Omni sin necesidad de modificaciones.

Para conectarte al servidor de base 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 base 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 base de datos, puedes definir, consultar y modificar tus bases de datos con consultas de DML y SQL mediante protocolos de comunicación estándar de PostgreSQL.

Debido a que 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 a este servicio según las necesidades de tu aplicación, al igual que lo harías con un servidor PostgreSQL normal.

¿Qué sigue?