Conectar usando um cliente psql,Conectar usando um cliente psql,Conectar usando um cliente psql,Conectar usando um cliente psql

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Você pode usar o cliente de linha de comando do PostgreSQL para se conectar ao Cloud SQL. Esta página descreve como conectar um cliente psql à sua instância do Cloud SQL, seja ela executada localmente na máquina cliente, em uma VM do Compute Engine ou no Cloud Shell.

Antes de começar

Antes de usar um cliente psql para se conectar à sua instância do Cloud SQL, faça o seguinte:

• Crie uma instância do Cloud SQL, incluindo a configuração do usuário padrão.

  Consulte Criar instâncias e Definir a senha para a conta de usuário padrão .

• Opcionalmente, crie uma instância de VM do Compute Engine e conecte-se a ela usando SSH.

  Consulte Criar e iniciar uma instância de VM , Sobre conexões SSH ou Conectar-se a VMs do Windows usando RDP .

• Determine como você se conectará à sua instância.

  Para saber as opções de conexão e como escolher entre elas, consulte Sobre as opções de conexão .

Use um cliente PostgreSQL em uma máquina local ou em uma VM do Compute Engine

Usar um cliente psql para se conectar à sua instância do Cloud SQL envolve três tarefas de alto nível:

1. Instale o cliente .
2. Configure o acesso à sua instância do Cloud SQL .
3. Conecte-se à sua instância do Cloud SQL .

Instalar o cliente

Para instalar o cliente psql , faça o seguinte:

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

sudo yum install postgresql

sudo zypper install postgresql

Configurar o acesso à sua instância do Cloud SQL

Para configurar o acesso à sua instância, faça o seguinte:

1. Na máquina cliente ou na instância de VM do Compute Engine, use Qual é meu IP para ver o endereço IP da máquina cliente.
2. Copie esse endereço IP.

3. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

4. Para abrir a página Visão geral de uma instância, clique no nome da instância.
5. Selecione Conexões no menu de navegação SQL.
6. Selecione a aba Rede .
7. Na seção Redes autorizadas , clique em Adicionar rede e insira o endereço IP da máquina onde o cliente está instalado.
8. Clique em Concluído . Em seguida, clique em Salvar na parte inferior da página para salvar suas alterações.
9. Conecte-se à sua instância usando SSL/TLS ou sem criptografia (sem usar SSL/TLS) .

Conecte-se à sua instância do Cloud SQL sem criptografia

Para permitir a conexão sem criptografia, a instância deve ter o modo SSL definido como ALLOW_UNENCRYPTED_AND_ENCRYPTED . No Google Cloud console, a configuração equivalente é Permitir tráfego de rede não criptografado .

Para obter mais informações sobre a configuração SSL/TLS da sua instância, consulte Configurar certificados SSL/TLS .

Para se conectar à sua instância, faça o seguinte:

1. Confirme se você instalou o cliente e configurou o acesso à sua instância .
2. Inicie o cliente psql :

   psql "sslmode=disable dbname=postgres user=postgres hostaddr=INSTANCE_IP_ADDRESS"

3. Digite sua senha.
4. O prompt do psql aparece.

Conecte-se à sua instância do Cloud SQL usando SSL/TLS

Para se conectar à sua instância usando SSL/TLS e autenticação integrada:

1. Inicie o cliente psql :

   psql "sslmode=require \
         hostaddr=INSTANCE_IP_ADDRESS \
         user=postgres dbname=DB_NAME"
      

   Por exemplo:

   psql "sslmode=require \
         hostaddr=203.12.34.56 \
         user=postgres dbname=postgres"
      

   Você também pode criar um Arquivo de Serviço de Conexão para gerenciar seus parâmetros de conexão, especialmente se estiver se conectando a mais de uma instância. Para mais informações, consulte a documentação do PostgreSQL .

2. Digite a senha. A senha é obrigatória para o Cloud SQL, embora o PostgreSQL suporte conectividade sem senha ao usar SSL/TLS.
3. Você pode confirmar se a conexão está criptografada procurando a cifra nas informações de conexão:

   SSL connection (cipher: ECDHE-RSA-AES128-GCM-SHA256, bits: 128)
   

Conecte-se à sua instância do Cloud SQL usando SSL/TLS e verificação de certificado de cliente

Se ssl_mode na sua instância do Cloud SQL estiver configurado como TRUSTED_CLIENT_CERTIFICATE_REQUIRED , você também deverá fornecer uma identidade de cliente verificada ao efetuar login.

Para conectar usando certificados SSL/TLS com verificação de cliente, você precisa do seguinte:

• Um certificado de chave pública do cliente em um arquivo client-cert.pem .
• Uma chave privada do cliente em um arquivo client-key.pem .

Além disso, para permitir que o cliente verifique a identidade do servidor para autenticação mútua, especifique o certificado do servidor server-ca.pem .

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

Se você não tiver um certificado de cliente e uma chave privada correspondente, crie um novo certificado de cliente .

Usando o cliente no Cloud Shell

O que vem a seguir

• Saiba mais sobre como configurar uma instância com um endereço IP privado .
• Saiba mais sobre as opções para se conectar à sua instância a partir do seu aplicativo .
• Aprenda como o cliente psql funciona com SSL .