Execute e ligue-se ao AlloyDB Omni

Selecione uma versão da documentação:

Esta página descreve como executar e estabelecer ligação ao AlloyDB Omni depois de o instalar 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 esta ferramenta de linha de comandos no seu computador, consulte o artigo Instale a CLI do AlloyDB Omni.

Execute o AlloyDB Omni

Os procedimentos que usa para executar o AlloyDB Omni dependem do facto de estar a executar o AlloyDB Omni num contentor num único servidor.

A instalação do AlloyDB Omni configura um serviço do sistema denominado alloydb-dataplane, que é configurado para ser iniciado sempre que a sua máquina é iniciada.

Para o controlo e a monitorização básicos do AlloyDB Omni, use o comando sudo alloydb, conforme demonstrado nas secções seguintes.

Inicie o AlloyDB Omni

sudo alloydb database-server start

Para fazer uma ligação de teste, consulte o artigo Estabeleça ligação através da versão em contentor psql.

Verifique o estado do AlloyDB Omni

sudo alloydb database-server status

Pare o AlloyDB Omni

sudo alloydb database-server stop

Desative o início no arranque

A execução do seguinte comando impede que o AlloyDB Omni seja iniciado automaticamente quando a máquina é iniciada.

sudo systemctl disable alloydb-dataplane

Reative o início no arranque

  sudo systemctl enable alloydb-dataplane

Estabeleça ligação ao AlloyDB Omni em execução num único servidor

O contentor do AlloyDB Omni inclui a sua própria cópia do psql que lhe permite abrir uma sessão de shell SQL interativa com o respetivo servidor de base de dados.

Também pode estabelecer ligação ao AlloyDB Omni a partir do exterior do contentor, usando o software compatível com PostgreSQL da sua escolha.

Faça a associação através do psql em contentor

Para se ligar ao servidor de base de dados do AlloyDB Omni através da respetiva cópia em contentor de psql, execute o seguinte comando:

Servidor único 

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

Este comando estabelece ligação ao servidor como a função de utilizador postgres e apresenta um pedido de comando postgres=#. Agora, pode executar psqlcomandos e consultas SQL.

Para sair do modo psql, execute o comando \q.

Estabeleça ligação através das suas próprias aplicações

Qualquer aplicação que funcione com o PostgreSQL também pode funcionar com o AlloyDB Omni, sem necessidade de modificação.

Para se ligar ao servidor de base de dados do AlloyDB Omni, use qualquer cliente ou biblioteca de código compatível com o PostgreSQL para se ligar à porta 5432, a porta do servidor de base de dados do PostgreSQL predefinida, da máquina que executa o AlloyDB Omni.

Isto funciona porque o contentor do AlloyDB Omni expõe a sua própria porta 5432 à mesma porta da máquina em que é executado.

Depois de estabelecer ligação ao servidor da base de dados, pode definir, consultar e modificar as suas bases de dados através de consultas DML e SQL, usando protocolos de comunicação PostgreSQL padrão.

Uma vez que o AlloyDB Omni é executado no seu próprio ambiente, pode controlar a forma como se liga ao AlloyDB Omni. Isto inclui permitir ou restringir o acesso à rede a este serviço de acordo com as necessidades da sua aplicação, tal como faria com um servidor PostgreSQL normal.

O que se segue?