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.

Ejecuta AlloyDB Omni

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

Cómo iniciar 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 le asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

Podman 

podman container start CONTAINER_NAME

Reemplaza CONTAINER_NAME por el nombre que le 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 salida. La fila correspondiente resume el estado del contenedor.

Si el nombre de tu contenedor no aparece en la columna NAMES, significa que tu instancia de 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 le asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

Podman 

  podman container stop CONTAINER_NAME

Reemplaza CONTAINER_NAME por el nombre que le 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 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.

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 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:

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

Reemplaza CONTAINER_NAME por el nombre que le 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 le asignaste al contenedor de AlloyDB Omni cuando lo instalaste.

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, expón la red 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 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?