Conectar um cliente psql a uma instância

Nesta página, descrevemos como conectar a ferramenta de cliente psql a uma instância do AlloyDB.

O procedimento para conectar o psql a uma instância do AlloyDB envolve estas tarefas:

  1. Crie uma VM do Compute Engine que possa se conectar a instâncias do AlloyDB usando o acesso privado a serviços.
  2. Instale o cliente psql na VM do Compute Engine.
  3. Consiga o endereço IP da instância do AlloyDB a que você quer se conectar.
  4. Execute o cliente psql.

As duas primeiras tarefas são operações únicas. Depois de criar uma VM do Compute Engine e instalar o cliente psql nela, você pode continuar usando a VM para conectar psql às instâncias do AlloyDB realizando as tarefas restantes.

Antes de começar

  • O projeto Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • Uma rede VPC no projeto Google Cloud que você está usando já precisa estar configurada para acesso a serviços particulares do AlloyDB.
  • Você precisa ter um destes papéis do IAM no projeto Google Cloud que está usando:
    • roles/alloydb.admin (o papel predefinido do IAM de administrador do AlloyDB)
    • roles/owner (o papel básico Proprietário do IAM)
    • roles/editor (o papel básico de editor do IAM)

    Se você não tiver nenhum desses papéis, entre em contato com o administrador da organização para solicitar acesso.

  • Se o host cliente tiver um firewall, ele precisará permitir conexões de saída com a porta 5432 nos endereços IP das instâncias do AlloyDB.

Criar uma VM do Compute Engine

  1. No Google Cloud console, acesse a página Instâncias de VM:

    Acessar instâncias de VM

  2. Selecione o projeto que contém a instância do AlloyDB a que você quer se conectar.
  3. Clique em Criar instância.
  4. Clique na seção Configuração da máquina.
  5. Digite um Nome para a instância.
  6. Configure a região e a zona em que você quer criar a instância.
  7. Selecione uma série e o tipo de máquina correspondente.
  8. Mantenha os valores padrão na seção SO e armazenamento.
  9. Clique na seção Rede e defina Interfaces de rede como a rede VPC configurada para acesso a serviços particulares ao AlloyDB.
    Se Interfaces de rede não estiver definido como a rede VPC configurada para acesso a serviços particulares, expanda e defina Rede como a rede VPC.
  10. Mantenha os valores padrão na seção Observabilidade.
  11. Clique na seção Segurança.
  12. Em Identidade e acesso à API, defina os Escopos de acesso como Permitir acesso total a todas as APIs do Cloud.
  13. Mantenha os valores padrão na seção Avançado.
  14. Clique em Criar.

Depois que a VM for criada, conecte-se à VM do Compute Engine criada usando SSH.

Instalar a ferramenta de cliente psql

  1. Conecte-se à VM do Compute Engine que você criou usando SSH.

    Console

    1. No console Google Cloud , acesse a página Instâncias de VM.

      Acessar instâncias de VM

    2. Na lista de instâncias de máquina virtual, clique em SSH na linha da instância que você criou.

    gcloud

    Use o comando gcloud compute ssh para se conectar à instância criada.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Substitua:

    • PROJECT_ID: o ID do projeto que contém a instância
    • ZONE: o nome da zona em que a instância está localizada.
    • VM_NAME: o nome da instância.
  2. Instale o cliente psql do gerenciador de pacotes: 
    sudo apt-get update
sudo apt-get install postgresql-client

Acessar o endereço IP da instância do AlloyDB

Para conferir o endereço IP da instância do AlloyDB a que você quer se conectar, consulte as configurações dela.

Executar o cliente psql

  1. Conecte-se à VM criada usando SSH.

    Console

    1. No console Google Cloud , acesse a página Instâncias de VM.

      Acessar instâncias de VM

    2. Na lista de instâncias de máquina virtual, clique em SSH na linha da instância que você criou.

    gcloud

    Use o comando gcloud compute ssh para se conectar à instância criada.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Substitua:

    • PROJECT_ID: o ID do projeto que contém a instância.
    • ZONE: o nome da zona em que a instância está localizada.
    • VM_NAME: o nome da instância.
  2. Execute a ferramenta de cliente psql: 
    psql -h IP_ADDRESS -U USERNAME -d postgres

    Será necessário inserir a senha do usuário USERNAME.

    Se você estiver se conectando pela primeira vez, especifique postgres para USERNAME e o banco de dados. Seu comando será semelhante a este:

    psql -h IP_ADDRESS -U postgres -d postgres

    Use a senha definida ao criar o cluster.