Como conectar o cliente psql usando IP público

Nesta página, você verá como conectar um cliente psql à sua instância do Cloud SQL executando localmente na máquina do seu cliente ou no Cloud Shell

Antes de começar

Antes de começar a usar o cliente psql, lembre-se dos seguintes pré-requisitos:

Como usar um cliente psql local

A utilização de um cliente psql local para se conectar à instância do Cloud SQL envolve três tarefas gerais:

  1. Instalar o cliente psql.
  2. Configurar o acesso à instância do Cloud SQL.
  3. Conectar-se à instância do Cloud SQL.

Instalar o cliente psql

Para instalar o cliente psql:

Debian/Ubuntu

Instale o cliente psql do gerenciador de pacotes:

sudo apt-get update
sudo apt-get install postgresql-client

CentOS/RHEL

Instale o cliente psql do gerenciador de pacotes:

sudo yum install postgresql

openSUSE

Instale o cliente psql do gerenciador de pacotes:

sudo zypper install postgresql

Outras plataformas

  1. Faça o download do PostgreSQL Core Distribution referente à sua plataforma na página de downloads do PostgreSQL (em inglês).
    O Core Distribution inclui o cliente psql.
  2. Instale o banco de dados do PostgreSQL seguindo as instruções na página de download.

Configurar o acesso à instância do Cloud SQL

Para configurar o acesso à instância:

  1. A partir de uma máquina com psql instalado, navegue até o site What's my IP para ver o endereço IP dela.
  2. Copie o endereço IP.
  3. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud Platform.

    Acessar a página Instâncias do Cloud SQL

  4. Clique na instância para abrir a página Visão geral correspondente e registre o endereço IP.
  5. Selecione a guia Conexões.
  6. Em Redes autorizadas, clique em Adicionar rede e insira o endereço IP da máquina em que o psql está instalado.
  7. Clique em Concluído e em Salvar na parte inferior da página para salvar as alterações.
  8. Conecte-se à instância com SSL ou sem SSL.

Conectar-se à instância do Cloud SQL sem criptografia

Para conectar-se à instância:

  1. Instale o cliente psql e configure o acesso à instância, se ainda não tiver feito isso.
  2. Inicie o cliente psql:
    psql "sslmode=disable dbname=postgres user=postgres hostaddr=[INSTANCE_IP]"
    
  3. Digite sua senha.
  4. Você verá o prompt do psql.

Precisa de ajuda? Para ajuda na solução de problemas com o proxy, consulte Como solucionar problemas nas conexões do Cloud SQL Proxy Você também pode consultar a página de suporte do Cloud SQL.

Conectar-se à instância do Cloud SQL usando SSL

Para conectar-se à instância usando SSL:

  1. Se você ainda não tiver um certificado cliente e a chave privada correspondente, crie um certificado seguindo as instruções em Como criar um novo certificado cliente.

    Você precisa ter estes três itens:

    • um certificado de autoridade de certificação (CA, na sigla em inglês) que tenha o texto em um arquivo chamado server-ca.pem
    • um certificado de chave pública do cliente que tenha o texto em um arquivo chamado client-cert.pem
    • Uma chave privada do cliente, com o texto dela em um arquivo chamado client-key.pem.
  2. Instale o cliente psql e configure o acesso à instância, se ainda não tiver feito isso.
  3. Inicie o cliente psql:
    psql "sslmode=verify-ca sslrootcert=server-ca.pem \
          sslcert=client-cert.pem sslkey=client-key.pem \
          hostaddr=[INSTANCE_IP] \
          user=postgres dbname=[DB_NAME]"
    

    Exemplo:

    psql "sslmode=verify-ca sslrootcert=server-ca.pem \
          sslcert=client-cert.pem sslkey=client-key.pem \
          hostaddr=01.23.45.67 \
          user=postgres dbname=postgres"
          

    verify-full não é necessário. verify-ca é suficiente porque a CA é específica da instância.

    Os parâmetros sslcert e sslkey são opcionais. Se forem fornecidos, o servidor verificará a identidade do cliente.

    Talvez também seja útil criar um arquivo de serviço de conexão para gerenciar seus parâmetros de conexão, especialmente se você estiver se conectando a mais de uma instância. Para conferir mais informações, veja a documentação do PostgreSQL.

  4. Digite a senha.
  5. Você pode confirmar se a conexão é criptografada procurando o código nas informações de conexão:
    SSL connection (cipher: ECDHE-RSA-AES128-GCM-SHA256, bits: 128)
    

Precisa de ajuda? Para ajuda na solução de problemas com o proxy, consulte Como solucionar problemas nas conexões do Cloud SQL Proxy Você também pode consultar a página de suporte do Cloud SQL.

Como usar o cliente psql no Cloud Shell

  1. Acesse o Console do Google Cloud Platform.

    Acessar o Console do Google Cloud Platform

  2. Clique no ícone do Cloud Shell à direita da barra de ferramentas.

    O Cloud Shell leva alguns instantes para inicializar.

  3. No prompt do Cloud Shell, use o cliente psql integrado para se conectar à instância do Cloud SQL:
    gcloud sql connect [INSTANCE_ID] --user=postgres
    
  4. Digite sua senha.

As conexões do Cloud Shell não são compatíveis com SSL.

Precisa de ajuda? Para ajuda na solução de problemas com o proxy, consulte Como solucionar problemas nas conexões do Cloud SQL Proxy ou consulte a página de suporte do Cloud SQL.

Próximas etapas

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud SQL para PostgreSQL