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.

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.

Inicie o AlloyDB Omni

Para iniciar um contentor do AlloyDB Omni parado, execute o comando docker container start ou o comando podman container start:

Docker 

docker container start CONTAINER_NAME

Substitua CONTAINER_NAME pelo nome que atribuiu ao contentor do AlloyDB Omni quando o instalou.

Podman 

podman container start CONTAINER_NAME

Substitua CONTAINER_NAME pelo nome que atribuiu ao contentor do AlloyDB Omni quando o instalou.

Verifique o estado do AlloyDB Omni

Para verificar o estado de todos os contentores que tem em execução, execute o comando docker container ls ou o comando podman container ls:

Docker 

docker container ls

Podman 

podman container ls

Se o contentor do AlloyDB Omni estiver em execução, o respetivo nome é apresentado na coluna NAMES da tabela de saída. A linha correspondente resume o estado do contentor.

Se o nome do seu contentor não aparecer na coluna NAMES, significa que o AlloyDB Omni não está em execução.

Pare o AlloyDB Omni

Para parar um contentor do AlloyDB Omni, execute o comando docker container stop ou o comando podman container stop:

Docker 

  docker container stop CONTAINER_NAME

Substitua CONTAINER_NAME pelo nome que atribuiu ao contentor do AlloyDB Omni quando o instalou.

Podman 

  podman container stop CONTAINER_NAME

Substitua CONTAINER_NAME pelo nome que atribuiu ao contentor do AlloyDB Omni quando o instalou.

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.

Para obter informações sobre a ligação a um cluster de base de dados do AlloyDB Omni em execução num cluster do Kubernetes, consulte o artigo Estabeleça ligação ao AlloyDB Omni em execução no Kubernetes.

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:

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

Substitua CONTAINER_NAME pelo nome que atribuiu ao contentor do AlloyDB Omni quando o instalou.

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

Substitua CONTAINER_NAME pelo nome que atribuiu ao contentor do AlloyDB Omni quando o instalou.

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, exponha a rede do contentor Docker do AlloyDB Omni à sua máquina anfitriã adicionando --network=host ou -p 5432:5432 ao comando docker run ou podman run quando iniciar o AlloyDB Omni.

Para selecionar um número de porta personalizado, use -p [HOST_PORT]:5432 quando iniciar o AlloyDB Omni. Em seguida, use qualquer cliente ou biblioteca de código compatível com PostgreSQL para se ligar à porta 5432 ou ao número da porta personalizado que especificou.

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?