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.