Conectar-se ao Cloud SQL para MySQL pelo Cloud Shell

Nesta página, mostramos como criar e se conectar a uma instância do MySQL e realizar operações básicas de SQL usando o console Trusted 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

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

    Go to project selector

  2. Make sure that billing is enabled for your Trusted Cloud project.

  3. Ative as APIs do Google Cloud necessárias.

    Console

    No console Trusted Cloud , 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 recursos do Trusted Cloud 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

  4. Make sure that you have the following role or roles on the project: Cloud SQL Admin (roles/cloudsql.admin), Cloud SQL Viewer (roles/cloudsql.viewer)

    Check for the roles

    1. In the Trusted Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Trusted Cloud console, go to the IAM page.

      Acessar o IAM
    2. Selecionar um projeto.
    3. Clique em CONCEDER ACESSO.

    4. No campo Novos principais, insira seu identificador de usuário. Normalmente, é o identificador de um usuário em um pool de identidades de força de trabalho. Para mais detalhes, consulte Representar usuários do pool de força de trabalho nas políticas do IAM ou entre em contato com seu administrador.

    5. Na lista Selecionar um papel, escolha um.
    6. Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.
    7. Clique em Salvar.

crie uma instância do Cloud SQL

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

  1. No console Trusted 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 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.

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.

  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 Trusted Cloud console, clique no ícone do Cloud Shell (Í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)$

  3. Opcional: se você não autorizou a gcloud CLI a acessar a Trusted Cloud by S3NS Plataforma 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 permitir que o Cloud Shell faça 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 sua instância do Cloud SQL está sendo permitido para receber conexões. Depois dessa mensagem, você precisará inserir 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>

Limpar

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

  1. No console Trusted Cloud , 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 console Trusted Cloud , acesse a página APIs.

    Acesse APIs

  2. Selecione a API Cloud SQL Admin e clique no botão Desativar API.

A seguir