Guia de início rápido do Cloud SQL para PostgreSQL

Nesta página, você verá como criar e se conectar a uma instância do PostgreSQL, além de executar operações SQL básicas usando o Console do Google Cloud e um cliente. Os recursos criados neste guia de início rápido normalmente custam menos do que um dólar, supondo que você conclua as etapas, incluindo a limpeza, em tempo hábil.

Crie o projeto

Antes de realizar as etapas neste guia de início rápido, conclua as tarefas a seguir:

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. Verifique se você tem o papel "Cliente do Cloud SQL" na conta de usuário.

    Acessar a página IAM

  5. Ative a API Cloud SQL Admin.

    Ative a API

crie uma instância do Cloud SQL

Neste procedimento, você usa o Console do Google Cloud. Para usar a ferramenta de linha de comando gcloud, cURL ou PowerShell, consulte Como criar instâncias.

  1. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique em Criar instância.
  3. Clique em PostgreSQL.
  4. Se você receber uma solicitação para ativar a API Compute, clique no botão Ativar API.
  5. Insira myinstance para o ID da instância.
  6. Insira uma senha para o usuário postgres.
  7. Use os valores padrão dos outros campos.
  8. Clique em Criar.

    Você retorna à lista de instâncias. É possível clicar na nova instância imediatamente para ver os detalhes, mas ela não estará disponível até que seja inicializada.

    Observação: nesse exemplo, a instância é criada usando configurações padrão, incluindo um endereço IP público.

Conecte-se à sua instância usando o cliente psql no Cloud Shell

  1. No Console do Google Cloud, clique no ícone do Cloud Shell (Ícone do Cloud Shell) no canto superior direito.

    Quando a inicialização do Cloud Shell terminar, aparecerá o seguinte:

    Welcome to Cloud Shell! Type "help" to get started.
    username@example-id:~$
    
  2. No prompt do Cloud Shell, conecte-se à instância do Cloud SQL:

    gcloud sql connect myinstance --user=postgres
    
  3. Insira a senha do postgres.

    Será exibida a solicitação psql.

Criar um banco de dados e fazer upload de dados

  1. Crie um banco de dados SQL na sua instância do Cloud SQL:
    CREATE DATABASE guestbook;
    
  2. Conecte-se ao banco de dados:
    \connect guestbook;
    
  3. Insira dados de amostra no banco de dados:
    CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                            entryID SERIAL PRIMARY KEY);
    INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
    INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');
    
  4. Recupere os dados:
    SELECT * FROM entries;
    
    O resultado será:
      guestname   |   content   | entryid
    --------------+-------------+---------
     first guest  | I got here! |       1
     second guest | Me too!     |       2
    (2 rows)
    postgres=>
    

Limpeza

  1. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Selecione o nome da instância para abrir a página Visão geral.
  3. Na barra de ícones na parte superior da página, clique em Excluir.
  4. Na janela Excluir instância, digite o nome da sua instância e clique em Excluir para excluí-la.

    Após a exclusão da instância, o mesmo nome não poderá ser usado por aproximadamente sete dias.

A seguir

Com base nas suas necessidades, é possível saber mais sobre como criar instâncias do Cloud SQL.

Também é possível aprender a criar usuários do PostgreSQL e bancos de dados para sua instância do Cloud SQL.

Consulte também as informações de preços do Cloud SQL.

Neste guia de início rápido, você se conectou à instância usando o Cloud Shell. Na maioria dos casos de uso, o método de conexão depende da configuração de rede e considera:

  • se a instância do Cloud SQL tem um endereço IP público ou privado;
  • se você está se conectando de dentro do Google Cloud (do mesmo projeto ou de um projeto diferente);
  • se você está se conectando de fora do Google Cloud.

Saiba mais sobre estas situações:

Além disso, é possível aprender a se conectar a uma instância do Cloud SQL usando outros aplicativos do Google Cloud, como: