Executar e se conectar ao AlloyDB Omni

Selecione uma versão da documentação:

Nesta página, descrevemos como executar e se conectar ao AlloyDB Omni depois de instalá-lo na sua própria 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 é 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 fazer um teste de conexão, consulte Conectar usando o psql em contêineres.

Verificar o status do AlloyDB Omni

sudo alloydb database-server status

Interromper o AlloyDB Omni

sudo alloydb database-server stop

Desativar a inicialização na inicialização

Executar o 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 na 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 uma cópia própria 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 PostgreSQL de sua escolha.

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 de psql, execute o seguinte comando:

Servidor único 

docker exec -it pg-service psql -h localhost -U postgres

Esse comando conecta você ao servidor como a função do usuário postgres e mostra um prompt de comando postgres=#. Agora é possível executar comandos psql 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ódigo compatível com PostgreSQL para se conectar à porta 5432, que é a porta padrão do servidor de banco de dados 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 seus bancos de dados usando consultas DML e SQL com protocolos de comunicação padrão do PostgreSQL.

Como o AlloyDB Omni é executado no seu ambiente, você pode controlar como se conecta a ele. Isso inclui permitir ou restringir o acesso à rede a esse serviço de acordo com as necessidades do seu aplicativo, assim como faria com um servidor PostgreSQL comum.

A seguir