Conectar-se ao Cloud SQL para PostgreSQL pelo Cloud Shell
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 de um dólar, supondo que você conclua as etapas, incluindo a limpeza, em tempo hábil.
Antes de começar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Ative as APIs do Google Cloud necessárias.
Console
No console do Google Cloud, acesse a página APIs.
Ative a API Cloud SQL Admin.gcloud
Clique no botão a seguir para abrir o Cloud Shell, que fornece acesso de linha de comando aos recursos do Google Cloud diretamente no navegador. O Cloud Shell pode ser usado para executar os comandos
gcloud
apresentados neste guia de início rápido.Execute o comando
gcloud services enable
da seguinte maneira usando o Cloud Shell para ativar as APIs necessárias para este guia de início rápido:gcloud services enable sqladmin.googleapis.com
Esse comando ativa as seguintes APIs:
- API Cloud SQL Admin
Criar uma instância do Cloud SQL
Neste guia de início rápido, você usa o console do Google Cloud. Para usar a CLI gcloud, o cURL ou o PowerShell, consulte Criar instâncias.
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Clique em Criar instância.
- Clique em Escolher PostgreSQL.
- Insira
myinstance
para o ID da instância. - Digite a senha do usuário
postgres
. Clique em Criar.
Você retornará à lista de instâncias. É possível clicar na nova instância imediatamente para ver os detalhes, mas ela não estará disponível para outras operações até que seja inicializada.
Conecte-se à instância
Neste guia de início rápido, usaremos o cliente psql no Cloud Shell para se conectar à instância.
- Opcional: se você estiver executando uma instância local do PostgreSQL, interrompa-a antes
de se conectar à instância do Cloud SQL. Caso contrário, poderão ocorrer
erros como
address already in use
. No Console do Google Cloud, clique no ícone do Cloud Shell () no canto superior direito.
Quando o Cloud Shell concluir a inicialização, será exibida uma mensagem como esta:
Welcome to Cloud Shell! Type "help" to get started. Your Cloud Platform project in this session is set to sample-project. Use "gcloud config set project [PROJECT_ID]" to change to a different project. username@sample-project:~ (sample-project)$
No prompt do Cloud Shell, conecte-se à instância do Cloud SQL. Use o comando
gcloud sql connect
da seguinte maneira. Substitua o nome da instância se o nome dela for diferente.gcloud sql connect myinstance --user=postgres
- Clique em Autorizar na caixa de mensagem para autorizar o Cloud Shell a fazer chamadas de API.
Uma mensagem indica que o IP está sendo permitido para conexões de entrada. Depois disso, você precisará inserir sua senha.
Insira a senha do postgres.
Será exibida a solicitação
psql
.
Criar um banco de dados e fazer upload de dados
- Crie um banco de dados SQL na sua instância do Cloud SQL:
CREATE DATABASE guestbook;
- Conecte-se ao banco de dados inserindo o comando a seguir e especificando
sua senha.
\connect guestbook;
- 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!');
- Recupere os dados:
O resultado será:SELECT * FROM entries;
guestname | content | entryid --------------+-------------+--------- first guest | I got here! | 1 second guest | Me too! | 2 (2 rows) postgres=>
Limpar
Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Selecione a instância do
myinstance
para abrir a página Detalhes da instância. - Na barra de ícones na parte superior da página, clique em Excluir.
- Na janela Excluir instância, digite o nome da instância e clique em Excluir.
Etapas de limpeza opcionais
Se você não estiver usando as APIs que foram ativadas como parte deste guia de início rápido, é possível desativá-las.
- APIs que foram ativadas neste guia de início rápido:
- API Cloud SQL Admin
No console do Google Cloud, acesse a página APIs.
Selecione a API Cloud SQL Admin e clique no botão Desativar API.
A seguir
Saiba mais sobre como criar instâncias do Cloud SQL.
Saiba mais sobre como criar usuários e bancos de dados do PostgreSQL para a instância do Cloud SQL.
Consulte 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. Saiba mais sobre todas as opções de conectividade no Cloud SQL. A maneira como você se conecta depende da configuração de rede, como se a instância do Cloud SQL tivesse um endereço IP público ou privado. Veja como configurar sua instância do Cloud SQL com um IP público e um endereço de IP particular.
Saiba como se conectar a uma instância do Cloud SQL usando outros aplicativos do Google Cloud: