Ejecutar y conectarse a AlloyDB Omni

Selecciona una versión de la documentación:

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

Ejecutar AlloyDB Omni

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

Iniciar AlloyDB Omni

Para iniciar un contenedor de AlloyDB Omni detenido, ejecuta el comando docker container start:

docker container start CONTAINER_NAME

Sustituye CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni al instalarlo.

Comprobar el estado de AlloyDB Omni

Para comprobar el estado de todos los contenedores que tienes en ejecución, ejecuta el comando docker container ls:

docker container ls

Si tu contenedor de AlloyDB Omni está en ejecución, su nombre aparecerá en la columna NAMES de la tabla de resultados. La fila correspondiente resume el estado del contenedor.

Si el nombre de tu contenedor no aparece en la columna NAMES, significa que tu AlloyDB Omni no está en ejecución.

Detener AlloyDB Omni

Para detener un contenedor de AlloyDB Omni, ejecuta el comando docker container stop:

docker container stop CONTAINER_NAME

Sustituye CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni al instalarlo.

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

Para obtener información sobre cómo conectarse a un clúster de base de datos de AlloyDB Omni que se ejecuta en un clúster de Kubernetes, consulta Conectarse a AlloyDB Omni que se ejecuta en Kubernetes.

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:

docker exec -it CONTAINER_NAME psql -U postgres

Sustituye CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni al instalarlo.

Este 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 la base de datos de AlloyDB Omni, expón la red del contenedor de Docker de AlloyDB Omni a tu máquina host añadiendo --network=host o -p 5432:5432 al comando docker run cuando inicies AlloyDB Omni.

Para seleccionar un número de puerto personalizado, usa -p [HOST_PORT]:5432 cuando inicies AlloyDB Omni. A continuación, usa cualquier cliente o biblioteca de código compatible con PostgreSQL para conectarte al puerto 5432 o al número de puerto personalizado que hayas especificado.

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.

Siguientes pasos