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 conectarse a él después de instalarlo en tu propia máquina.

Ejecuta AlloyDB Omni

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

Inicia AlloyDB Omni

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

Docker 

docker container start CONTAINER_NAME

Reemplaza CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

Podman 

podman container start CONTAINER_NAME

Reemplaza CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

Verifica el estado de AlloyDB Omni

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

Docker 

docker container ls

Podman 

podman container ls

Si tu contenedor de AlloyDB Omni se está ejecutando, 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 se está ejecutando.

Detén AlloyDB Omni

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

Docker 

  docker container stop CONTAINER_NAME

Reemplaza CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

Podman 

  podman container stop CONTAINER_NAME

Reemplaza CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

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 de shell de SQL interactiva 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.

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

Conéctate con el psql alojado en contenedores

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

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

Reemplaza CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

Reemplaza CONTAINER_NAME por el nombre que asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

Este comando te conecta al servidor como el rol de usuario postgres y muestra un símbolo del sistema de postgres=#. Ahora puedes ejecutar comandos de psql y consultas en 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 modificaciones.

Para conectarte al servidor de la base de datos de AlloyDB Omni, expón las herramientas de redes del contenedor de Docker de AlloyDB Omni a tu máquina anfitrión agregando --network=host o -p 5432:5432 a tu comando docker run o podman run cuando inicies AlloyDB Omni.

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

Después de conectarte al servidor de la base de datos, puedes definir, consultar y modificar tus bases de datos con consultas de DML y SQL a través de 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 AlloyDB Omni. Esto incluye permitir o restringir el acceso de red a este servicio según las necesidades de tu aplicación, tal como lo harías con un servidor de PostgreSQL común.

¿Qué sigue?