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.

La instalación de AlloyDB Omni configura un servicio del sistema llamado alloydb-dataplane que se configura 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.

Cómo iniciar AlloyDB Omni

sudo alloydb database-server start

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

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 evita que AlloyDB Omni se inicie automáticamente cuando se inicia tu máquina.

sudo systemctl disable alloydb-dataplane

Cómo volver a habilitar el inicio al encender el dispositivo

  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 bases 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 un contenedor

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

Un solo servidor

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

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

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 realizar modificaciones.

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

Dado 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 de PostgreSQL común.

¿Qué sigue?