Conectar-se ao Cloud SQL para SQL Server usando o proxy do Cloud SQL Auth

Conectar-se ao Cloud SQL para SQL Server usando o proxy do Cloud SQL Auth

MySQL   |  PostgreSQL   |  SQL Server

Nesta página, você verá como se conectar ao Cloud SQL de um ambiente de teste local usando o proxy do Cloud SQL Auth. O proxy do Cloud SQL Auth fornece acesso seguro à instância do Cloud SQL sem a necessidade de redes autorizadas ou de configuração do SSL. Ao usar o proxy do Cloud SQL Auth, é possível se conectar à instância do Cloud SQL com segurança.

As instruções nesta página são apenas para um ambiente de teste e não podem ser usadas em ambientes de produção. Para mais informações sobre a configuração necessária para ambientes de produção, consulte Usar o proxy do Cloud SQL Auth em um ambiente de produção e Conectar-se usando o proxy do Cloud SQL Auth.

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

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

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

   Console

   No console do Google 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 Google 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. 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 console do Google Cloud , 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 console do Google Cloud , 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 identificador de um usuário em um pool de identidades de força de trabalho. Saiba mais em Representar usuários do pool de força de trabalho nas políticas do IAM ou entre em contato com seu administrador.

   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 console Google Cloud . Para usar a CLI gcloud, curl ou PowerShell, consulte Criar instâncias.

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

   Acesse "Instâncias do Cloud SQL"

2. Clique em Criar instância.
3. No menu Criar instância, selecione Nova instância.
4. Clique em Escolher SQL Server.
5. No campo ID da instância, insira myinstance.
6. No campo Senha, insira uma senha para o usuário sqlserver.

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

Debian/Ubuntu

Para Debian/Ubuntu, instale as ferramentas de linha de comando aplicáveis do SQL Server seguindo estas instruções.

CentOS/RHEL

Para o CentOS/RHEL, instale as ferramentas de linha de comando aplicáveis do SQL Server seguindo estas instruções.

openSUSE

Para o openSUSE, instale as ferramentas de linha de comando aplicáveis do SQL Server seguindo estas instruções.

Outras plataformas

Consulte a página de destino e a página de downloads do SQL Server para instalar o SQL Server.

Instalar o cliente do proxy do Cloud SQL Auth

Para instalação, consulte Como instalar o proxy do Cloud SQL Auth.

Conseguir o nome da conexão da instância

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

   Acesse "Instâncias do Cloud SQL"

2. Clique no nome da instância para abrir a página Visão geral correspondente.
3. Na seção Conectar-se a esta instância, copie o Nome da conexão. O nome da conexão está no formato projectID:region:instanceID.

Iniciar o proxy do Cloud SQL Auth.

Inicie o proxy do Cloud SQL Auth em um terminal próprio para você monitorar a saída. Substitua INSTANCE_CONNECTION_NAME pelo nome da conexão da instância copiado no passo anterior.

Para ambientes Linux, use este comando para iniciar o proxy do Cloud SQL Auth:

./cloud-sql-proxy INSTANCE_CONNECTION_NAME

No PowerShell no Windows, use este comando para iniciar o proxy do Cloud SQL:

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

Você verá uma mensagem semelhante a esta:

Listening on 127.0.0.1:1433 for INSTANCE_CONNECTION_NAME
Ready for new connections

Execute o seguinte comando, substituindo USER_NAME pelo seu nome de usuário do SQL Server.

sqlcmd -S 127.0.0.1 -U USER_NAME

Volte para a janela do terminal em que você iniciou o proxy do Cloud SQL Auth. Você verá uma mensagem semelhante a esta:

New connection for myInstance

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 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 do Google Cloud , acesse a página APIs.

   Acesse APIs

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

A seguir

• Confira como solucionar problemas com informações sobre o proxy de autenticação do Cloud SQL.

• Saiba mais sobre o proxy do Cloud SQL Auth.