Conectar-se ao Cloud SQL para SQL Server pelo computador local

Saiba como implantar um app de exemplo em um computador local com Linux, macOS ou Windows conectado a uma instância do SQL Server usando o console Google Cloud e um aplicativo cliente.

Supondo que você conclua todas as etapas em tempo hábil, os recursos criados neste guia de início rápido normalmente custam menos de um dólar (USD).

Antes de começar

  1. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, 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. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Verifique se você tem as permissões necessárias para concluir este guia de início rápido.
  7. Ative as APIs do Cloud necessárias para executar um app de exemplo do Cloud SQL no computador local.

    Console

    Clique no botão Ativar APIs para ativar as APIs necessárias para este guia de início rápido.

    Ative as APIs

    Isso permite as seguintes APIs:

    • API Cloud SQL Admin
    • API IAM

    gcloud

    Instale a CLI gcloud, que fornece acesso de linha de comando aos seus recursos Google Cloud . A CLI gcloud é usada para executar os comandos gcloud CLI apresentados neste guia de início rápido. Todos os comandos são formatados para serem executados em um terminal Linux/macOS ou no Windows PowerShell.

    Abra o terminal e execute o seguinte comando gcloud:

    gcloud services enable sqladmin.googleapis.com iam.googleapis.com

    Esse comando ativa as seguintes APIs:

    • API Cloud SQL Admin
    • API IAM

Funções exigidas

Para ter as permissões necessárias para configurar o Cloud SQL no seu computador local, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto que você quer criar e conectar:

  • Criar ou excluir uma instância, um banco de dados e um usuário: Função de administrador do Cloud SQL (roles/cloudsql.admin).
  • Criar ou excluir uma conta de serviço do IAM: Função de administrador da conta de serviço do IAM (roles/iam.serviceAccountAdmin).
  • Adicionar ou remover uma vinculação de política do IAM: Função de administrador do IAM do projeto (roles/resourcemanager.projectIamAdmin).
  • Criar, gerenciar e trocar chaves da conta de serviço: Administrador de chaves da conta de serviço (roles/iam.serviceAccountKeyAdmin).

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Configurar o Cloud SQL

Para criar uma instância do Cloud SQL, faça o seguinte:

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

    Acesse "Instâncias do Cloud SQL"

  2. Selecione a guia "SQL Server" e clique em Criar instância do Sandbox na caixa Sandbox. Como alternativa, clique em Criar instância e conclua as etapas a seguir:
    1. Clique em Escolher SQL Server.
    2. Selecione a edição Enterprise.
    3. Escolha a predefinição Sandbox.
  3. Se você receber uma solicitação para ativar a API Compute, clique no botão Ativar API.
  4. Na seção Informações da instância, insira quickstart-instance como o ID da instância.
  5. Digite uma senha para o usuário sqlserver. Anote a senha criada porque você precisará dela mais tarde.
  6. Na seção Escolher região e disponibilidade por zona, selecione a opção Zona única.
  7. Clique em Criar instância.

Criar um banco de dados

Console

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

    Acesse "Instâncias do Cloud SQL"

  2. Selecione quickstart-instance.
  3. Abra a guia Bancos de dados.
  4. Clique em Criar banco de dados.
    1. Na caixa de diálogo Novo banco de dados, insira quickstart_db como o nome do banco de dados.
    2. Clique em Criar.

gcloud

Execute o comando gcloud sql databases create para criar um banco de dados.

gcloud sql databases create quickstart_db --instance=quickstart-instance

Configurar uma conta de serviço

Crie e configure uma Google Cloud conta de serviço que tenha o papel Cliente do Cloud SQL com permissões para se conectar ao Cloud SQL. Depois de criar uma conta de serviço, talvez seja necessário aguardar 60 segundos ou mais para usar essa conta.

Console

Criar uma conta de serviço

  1. No console Google Cloud , acesse a página Criar conta de serviço.
  2. Acesse "Criar conta de serviço"

  3. Selecionar um projeto do Google Cloud
  4. Insira quickstart-service-account como o nome da conta de serviço.
  5. Opcional: digite uma descrição da conta de serviço.
  6. Clique em Criar e continuar e avance para a próxima etapa.
  7. Escolha o papel de Cliente do Cloud SQL a ser concedido à conta de serviço no projeto.
  8. Clique em Continuar.
  9. Clique em Concluído para terminar a criação da conta de serviço.

Criar e fazer o download do arquivo de chave da conta de serviço

  1. No console Google Cloud , acesse a página Contas de serviço.
  2. Acesse as Contas de serviço

  3. Selecione um projeto.
  4. Clique no endereço de e-mail da conta de serviço quickstart-service-account para a qual você quer criar uma chave.
  5. Clique na guia Chaves.
  6. Clique no menu suspenso Adicionar chave e selecione Criar nova chave.
  7. Selecione JSON como o Tipo de chave e clique em Criar.

Clique em Criar para fazer o download de um arquivo de chave da conta de serviço. Após fazer o download do arquivo de chave, não será possível fazer o download novamente.

Armazene o arquivo de chave com segurança, porque ele pode ser usado como sua conta de serviço para autenticação. Mova e renomeie esse arquivo como quiser.

gcloud

Criar uma conta de serviço

  1. Para criar a conta de serviço, execute o comando gcloud iam service-accounts create:
  2. gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

    Substitua o seguinte valor:

    • DESCRIPTION: uma descrição opcional da conta de serviço.
  3. Para conceder o papel de cliente do Cloud SQL à sua conta de serviço no projeto, execute o comando gcloud projects add-iam-policy-binding. Substitua PROJECT_ID pelo ID do projeto do Google Cloud:
    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"

Criar e fazer o download do arquivo de chave da conta de serviço

Para usar a conta de serviço recém-criada no computador local, é necessário um arquivo de chave da conta de serviço para autenticar o aplicativo de exemplo como a conta de serviço. Para criar e fazer o download do arquivo de chave da conta de serviço, execute o comando gcloud iam service-accounts keys create:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Substitua os seguintes valores:

  • KEY_FILE: o caminho para um novo arquivo de saída para a chave privada. Por exemplo, ~/sa-private-key.json.
  • PROJECT_ID pelo ID do projeto no Google Cloud.

O download do arquivo de chave da conta de serviço foi feito no computador local. Após fazer o download do arquivo de chave, não será possível fazer o download novamente.

Armazene o arquivo de chave com segurança, porque qualquer pessoa pode usá-lo como sua conta de serviço para autenticação. Mova e renomeie esse arquivo como quiser.

Configurar o ambiente de desenvolvimento para a linguagem de programação

Configure o ambiente de desenvolvimento do computador local para a linguagem de programação de sua preferência.

Go

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento e executar o app de exemplo em Go.

  1. Acesse o guia de configuração de um ambiente de desenvolvimento em Go.
  2. Siga as instruções na seção Instalar Go.

Java

Conclua as etapas a seguir para configurar seu ambiente de desenvolvimento e executar o app de exemplo em Java.

  1. Acesse o guia de configuração de um ambiente de desenvolvimento em Java.
  2. Siga as instruções da seção Instalar um JDK (Java Development Kit).
  3. Conclua as instruções em Instalar uma ferramenta de automação de build para configurar o Apache Maven.

Node.js

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento e executar o app de exemplo em Node.js.

  1. Acesse o guia de configuração de um ambiente de desenvolvimento em Node.js.
  2. Siga as instruções na seção Como instalar o Node.js e o npm.

Python

Conclua as etapas a seguir para configurar seu ambiente de desenvolvimento para executar o app de exemplo em Python.

  1. Acesse o guia de configuração de um ambiente para desenvolvedores do Python.
  2. Siga as instruções na seção Como instalar o Python.

Instalar o Git

Instale o Git, um sistema de controle de versões de código aberto.

Clonar um aplicativo de exemplo

Clone um app de exemplo no computador local usando o comando git clone.

Go

Execute os seguintes comandos para clonar o app de exemplo em Go no computador local e alterar o diretório para o diretório que contém o app de exemplo.

  1. Clone o app de exemplo:
    git clone https://github.com/GoogleCloudPlatform/golang-samples
  2. Altere o diretório para o diretório que contém o app de exemplo.
    cd golang-samples/cloudsql/sqlserver/database-sql

Java

Execute os seguintes comandos para clonar o app de exemplo em Java no computador local e alterar o diretório para o diretório que contém o app de exemplo.

  1. Clone o app de exemplo:
    git clone https://github.com/GoogleCloudPlatform/java-docs-samples
  2. Altere o diretório para o diretório que contém o app de exemplo.
    cd java-docs-samples/cloud-sql/sqlserver/servlet

Node.js

Execute os seguintes comandos para clonar o app de exemplo em Node.js no computador local e alterar o diretório para o diretório que contém o app de exemplo.

  1. Clone o app de exemplo:
    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
  2. Altere o diretório para o diretório que contém o app de exemplo.
    cd nodejs-docs-samples/cloud-sql/sqlserver/mssql

Python

Execute os seguintes comandos para clonar o app de exemplo em Python no computador local e alterar o diretório para o diretório que contém o app de exemplo.

  1. Clone o app de exemplo:
    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
  2. Altere o diretório para o diretório que contém o app de exemplo.
    cd python-docs-samples/cloud-sql/sql-server/sqlalchemy

Configurar e executar o app de exemplo

Configurar e executar o app de exemplo

Limpar

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

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

    Acesse "Instâncias do Cloud SQL"

  2. Selecione a instância quickstart-instance 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 caixa de diálogo Excluir instância, digite quickstart-instance e clique em Excluir para excluir a instância.

Etapas de limpeza opcionais

Se você não estiver usando o papel Cliente do Cloud SQL que foi atribuído à conta de serviço quickstart-service-account, remova-o.

  1. No console Google Cloud , acesse a página Contas de serviço.

    Acessar IAM

  2. Clique no ícone de edição (parecido com um lápis) da conta do IAM chamada quickstart-service-account.
  3. Exclua o papel Cliente do Cloud SQL.
  4. Clique em Salvar.

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
    • API Identity and Access Management
  1. No console do Google Cloud , acesse a página APIs.

    Acesse APIs

  2. Selecione qualquer API que você quer desativar e clique no botão Desativar API.

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 SQL Server e bancos de dados para sua instância do Cloud SQL.

Para mais informações sobre preços, consulte Preços do Cloud SQL para SQL Server.

Saiba mais sobre estas situações:

  • 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: