Conectar-se ao Cloud SQL para MySQL pelo Cloud Shell

Conectar-se ao Cloud SQL para MySQL pelo Cloud Shell

MySQL   |  PostgreSQL   |  SQL Server

Esta página mostra como criar e se conectar a uma instância do MySQL e realizar operações básicas de SQL usando o Google Cloud console 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.

---

Para seguir as instruções detalhadas desta tarefa diretamente no Google Cloud console, clique em Orientação:

Orientações

---

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.

Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify 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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Ative as APIs do Cloud necessárias.

   Console

   No Google Cloud console, acesse a página APIs.

   Acesse 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 seus Google Cloud recursos diretamente no navegador. O Cloud Shell pode ser usado para executar os comandos gcloud apresentados neste guia de início rápido.

   Abra o Cloud Shell

   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

2. Verifique se você tem o seguinte papel ou papéis no projeto: Administrador do Cloud SQL (roles/cloudsql.admin)

   Verificar os papéis

   1. No Google Cloud console, acesse a página IAM.

      Acessar IAM
   2. Selecione o projeto.

   3. Na coluna Principal, encontre todas as linhas que identificam você ou um grupo no qual você está incluído. Para saber em quais grupos você está incluído, entre em contato com o administrador.

   4. Em todas as linhas que especificam ou incluem você, verifique a coluna Papel para ver se a lista de papéis inclui os papéis necessários.

   Conceder os papéis

   1. No Google Cloud console, acesse a página IAM.

      Acessar IAM
   2. Selecione o projeto.
   3. Clique em Conceder acesso.

   4. No campo Novos principais, digite seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

   5. Clique em Selecionar um papel e pesquise o papel.
   6. Para conceder outros papéis, adicione-os clicando em Adicionar outro papel.
   7. Clique em Salvar.

crie uma instância do Cloud SQL

Neste guia de início rápido, você usa o Google Cloud console. Para usar a CLI gcloud, o cURL ou o PowerShell, consulte Criar instâncias.

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

   Acesse "Instâncias do Cloud SQL"

2. Clique em Criar instância.
3. Clique em Escolher MySQL.
4. No campo ID da instância, insira myinstance.
5. No campo Senha, insira uma senha para o usuário root.

6. Clique em Criar instância.

   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.

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

Conecte-se à instância

Neste guia de início rápido, vamos usar o cliente mysql no Cloud Shell para a conexão com a instância. O Cloud Shell é um ambiente remoto em sandbox.

Observação: o Cloud Shell não funciona com um endereço IP particular. Estas instruções são apenas para uma instância com um endereço IP público.

1. Opcional: se você estiver executando uma instância local do MySQL, interrompa-a antes de se conectar à sua instância do Cloud SQL. Caso contrário, poderão ocorrer erros como address already in use.

2. No Google Cloud console, clique no ícone do Cloud Shell () no canto superior direito.

   Quando o Cloud Shell concluir a inicialização, será exibida uma mensagem como a seguinte:

   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)$
   

3. Opcional: se você não tiver autorizado a CLI gcloud a acessar o Google Cloud Platform com suas credenciais de usuário do Google, use o comando gcloud auth login.

4. 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=root

5. Na caixa de diálogo, clique em Autorizar para autorizar o Cloud Shell a fazer chamadas de API.

   A seguinte mensagem aparecerá:

   Allowlisting your IP for incoming connection for 5 minutes...done.
   

   Essa mensagem indica que o endereço IP público da instância do Cloud SQL está autorizado a receber conexões de entrada. Depois dessa mensagem, você vai precisar digitar sua senha.

6. Insira a senha raiz.

   Será exibida a solicitação mysql.

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. Insira dados de exemplo no banco de dados do livro de visitas:

   USE guestbook;
   CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
       entryID INT NOT NULL AUTO_INCREMENT, PRIMARY KEY(entryID));
       INSERT INTO entries (guestName, content) values ("first guest", "I got here!");
       INSERT INTO entries (guestName, content) values ("second guest", "Me too!");

3. Recupere os dados:

   SELECT * FROM entries;

   O resultado é:

   +--------------+-------------------+---------+
   | guestName    | content           | entryID |
   +--------------+-------------------+---------+
   | first guest  | I got here!       |       1 |
   | second guest | Me too!           |       2 |
   +--------------+-------------------+---------+
   2 rows in set (0.00 sec)
   mysql>
   

Liberar espaço

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

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

   Acesse "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 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

1. No Google Cloud console, acesse a página APIs.

   Acesse APIs

2. 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.

• Aprenda a criar usuários do MySQL e bancos de dados 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:

  • A partir de um aplicativo em execução no ambiente padrão do 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 Run