Executar e se conectar ao AlloyDB Omni

Selecione uma versão da documentação:

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 start

Para realizar um teste de conexão, consulte Conectar usando o em contêiner psql.

Verificar o status do AlloyDB Omni

sudo alloydb database-server status

Parar o AlloyDB Omni

sudo alloydb database-server stop

Desativar 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-dataplane

Reativar a inicialização

  sudo systemctl enable alloydb-dataplane

Conectar-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 postgres

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

A seguir