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.

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.

Iniciar o AlloyDB Omni

Para iniciar um contêiner do AlloyDB Omni interrompido, execute o comando docker container start ou o comando podman container start:

Docker 

docker container start CONTAINER_NAME

Substitua CONTAINER_NAME pelo nome que você atribuiu ao contêiner do AlloyDB Omni ao instalá-lo.

Podman 

podman container start CONTAINER_NAME

Substitua CONTAINER_NAME pelo nome que você atribuiu ao contêiner do AlloyDB Omni ao instalá-lo.

Verificar o status do AlloyDB Omni

Para verificar o status de todos os contêineres 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 contêiner do AlloyDB Omni estiver em execução, o nome dele vai aparecer na coluna NAMES da tabela de saída. A linha correspondente resume o estado do contêiner.

Se o nome do contêiner não aparecer na coluna NAMES, o AlloyDB Omni não está em execução.

Interromper o AlloyDB Omni

Para interromper um contêiner 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 você atribuiu ao contêiner do AlloyDB Omni ao instalá-lo.

Podman 

  podman container stop CONTAINER_NAME

Substitua CONTAINER_NAME pelo nome que você atribuiu ao contêiner do AlloyDB Omni ao instalá-lo.

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.

Para informações sobre como se conectar a um cluster de banco de dados do AlloyDB Omni em execução em um cluster do Kubernetes, consulte Conectar-se ao AlloyDB Omni em execução no Kubernetes.

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:

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

Substitua CONTAINER_NAME pelo nome que você atribuiu ao contêiner do AlloyDB Omni ao instalá-lo.

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

Substitua CONTAINER_NAME pelo nome que você atribuiu ao contêiner do AlloyDB Omni ao instalá-lo.

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

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

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