Esta página descreve como executar e se conectar ao AlloyDB Omni depois de você instalá-lo na sua máquina.
Antes de começar
A maioria dos comandos nesta página usa a CLI do AlloyDB Omni.
Para instalar essa ferramenta de linha de comando na sua máquina, consulte Instalar a CLI do AlloyDB Omni.
Executar o AlloyDB Omni
Os procedimentos usados para executar o AlloyDB Omni dependem de você estar executando o AlloyDB Omni em um contêiner em um único servidor.
A instalação do AlloyDB Omni configura um serviço de sistema chamado alloydb-dataplane, que é configurado para ser iniciado sempre que a máquina for inicializada.
Para controle e monitoramento básicos do AlloyDB Omni, use o comando sudo alloydb, conforme demonstrado nas seções a seguir.
Iniciar o AlloyDB Omni
sudo alloydb database-server startPara realizar um teste de conexão, consulte Conectar usando o em contêiner
psql.
Verificar o status do AlloyDB Omni
sudo alloydb database-server statusParar o AlloyDB Omni
sudo alloydb database-server stopDesativar a inicialização
A execução do comando a seguir impede que o AlloyDB Omni seja iniciado automaticamente quando a máquina é inicializada.
sudo systemctl disable alloydb-dataplaneReativar a inicialização
sudo systemctl enable alloydb-dataplaneConectar-se ao AlloyDB Omni em execução em um único servidor
O contêiner do AlloyDB Omni inclui a própria cópia do psql, que permite abrir uma sessão interativa do shell SQL com o servidor de banco de dados.
Também é possível se conectar ao AlloyDB Omni de fora do contêiner usando o software compatível com o PostgreSQL de sua preferência.
Conectar usando o psql em contêiner
Para se conectar ao servidor de banco de dados do AlloyDB Omni usando a própria cópia em contêiner do psql, execute o seguinte comando:
Servidor único
docker exec -it pg-service psql -h localhost -U postgresEsse comando conecta você ao servidor como o postgres função do usuário e mostra
um postgres=# prompt de comando. Agora é possível executar psql comandos e consultas SQL.
Para sair do psql, execute o comando \q.
Conectar usando seus próprios aplicativos
Qualquer aplicativo que funcione com o PostgreSQL também pode funcionar com o AlloyDB Omni, sem necessidade de modificação.
Para se conectar ao servidor de banco de dados do AlloyDB Omni, use qualquer cliente ou biblioteca de códigos compatível com o PostgreSQL para se conectar à porta 5432 (a porta padrão do servidor de banco de dados do PostgreSQL) da máquina que executa o AlloyDB Omni.
Isso funciona porque o contêiner do AlloyDB Omni expõe a própria porta 5432 à mesma porta da máquina em que é executado.
Depois de se conectar ao servidor de banco de dados, é possível definir, consultar e modificar os bancos de dados usando consultas DML e consultas SQL com protocolos de comunicação padrão do PostgreSQL.
Como o AlloyDB Omni é executado no seu próprio ambiente, é possível controlar como você se conecta a ele. Isso inclui permitir ou restringir o acesso à rede a esse serviço de acordo com as necessidades do aplicativo, assim como faria com um servidor PostgreSQL comum.