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

MySQL   |  PostgreSQL   |  SQL Server

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.

Antes de começar

Observação: o nome usado para seu projeto precisa ter entre 4 e 30 caracteres. Quando você digita o nome, o formulário sugere um ID do projeto, que pode ser editado. O ID do projeto precisa ter entre 6 e 30 caracteres, com uma letra minúscula como primeiro caractere. É possível usar um traço, uma letra minúscula ou um dígito para os caracteres restantes, mas o último caractere não pode ser um traço.

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.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   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.

Observação: se você estiver executando uma instância local do PostgreSQL, pare a instância antes de começar a trabalhar com uma instância do Cloud SQL. Caso contrário, poderão ocorrer erros como address already in use.

Criar uma instância

Neste procedimento, você usa o Console do Cloud. Para usar gcloud ou cURL, consulte Como criar instâncias.

1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

   Acessar a página "Instâncias" do Cloud SQL

2. Selecione o projeto e clique em Continuar.

3. Clique em Criar instância.

4. Clique em PostgreSQL.

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 () 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.

   O prompt do psql será exibido.

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

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.
   Acessar a página "Instâncias" do Cloud SQL
2. Selecione a instância do myinstance para abrir a página Detalhes da instância.
3. Na barra de ícones na parte superior da página, clique em Excluir.

4. Na janela Excluir instância, digite myinstance e clique em Excluir para excluir a instância.

   Após a exclusão da instância, o respectivo 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:

• Todas as opções de conectividade no Cloud SQL.
• Como configurar sua instância do Cloud SQL com um endereço IP público.
• Como configurar sua instância do Cloud SQL com um endereço IP privado.

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

• a partir de um aplicativo em execução no App Engine;
• a partir de um aplicativo em execução no Compute Engine;
• a partir de um aplicativo em execução no GKE;
• no Cloud Functions.
• a partir do Cloud Run (totalmente gerenciado).