使用 Cloud SQL Auth 代理连接到 Cloud SQL for SQL Server

使用 Cloud SQL Auth 代理连接到 Cloud SQL for SQL Server

MySQL   |  PostgreSQL   |  SQL Server

本页面介绍了如何使用 Cloud SQL Auth 代理从本地测试环境连接到 Cloud SQL。借助 Cloud SQL Auth 代理，您无需授权网络或配置 SSL，即可安全访问 Cloud SQL 实例。通过使用 Cloud SQL Auth 代理，您可以安全地连接到 Cloud SQL 实例。

本页面上的说明仅适用于测试环境，不应该用于生产环境。如需详细了解生产环境所需的配置，请参阅在生产环境中使用 Cloud SQL Auth 代理和使用 Cloud SQL Auth 代理进行连接。

准备工作

注意：您使用的项目名称必须包含 4 到 30 个字符。当您输入项目名称时，表单会向您推荐一个项目 ID，您可以修改该 ID。项目 ID 必须包含 6 到 30 个字符，且必须以小写字母开头。其余字符可以使用短划线、小写字母或数字，但最后一个字符不能是短划线。

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

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

   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

3. Make sure 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.

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. 启用必要的 Google Cloud API。

   控制台

   在 Google Cloud 控制台中，转到 API 页面。

   转到“API”

   启用 Cloud SQL Admin API。

   gcloud

   点击以下按钮打开 Cloud Shell，以通过命令行直接在浏览器中访问 Google Cloud 资源。Cloud Shell 可用于运行本快速入门中介绍的 gcloud 命令。

   打开 Cloud Shell

   按照以下方式使用 Cloud Shell 运行 gcloud services enable 命令，以启用本快速入门所需的 API。

   gcloud services enable sqladmin.googleapis.com

   此命令会启用以下 API：

   • Cloud SQL Admin API

创建 Cloud SQL 实例

在本快速入门中，您将使用 Google Cloud 控制台。如需使用 gcloud CLI、cURL 或 PowerShell，请参阅创建实例。

1. 在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

   转到“Cloud SQL 实例”

2. 点击创建实例。
3. 点击选择 SQL Server (Choose SQL Server)。
4. 在实例 ID 部分输入 myinstance。
5. 为 sqlserver 用户输入密码。

6. 点击创建。

   您会返回到实例列表。您可以立即点击新实例以查看详细信息，但该实例只能在初始化并启动之后才可用于其他操作。

   注意
   ：在此示例中，将使用默认设置（包括公共 IP 地址）创建实例。

Debian/Ubuntu

对于 Debian/Ubuntu，请按照这些说明安装适用的 SQL Server 命令行工具。

CentOS/RHEL

对于 CentOS/RHEL，请按照这些说明安装适用的 SQL Server 命令行工具。

openSUSE

对于 openSUSE，请按照这些说明安装适用的 SQL Server 命令行工具。

其他平台

如需了解如何安装 SQL Server，请参阅着陆页，以及 SQL Server 下载页面。

安装 Cloud SQL Auth 代理客户端

如需了解如何安装，请参阅安装 Cloud SQL Auth 代理。

获取实例连接名称

1. 在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

   转到“Cloud SQL 实例”

2. 点击实例名称，打开其概览页面。
3. 在连接到此实例部分，复制连接名称。连接名称的格式为 projectID:region:instanceID。

启动 Cloud SQL Auth 代理

在专有的终端中启动 Cloud SQL Auth 代理，以便监控其输出。将 INSTANCE_CONNECTION_NAME 替换为您在上一步中复制的实例连接名称。

对于 Linux 环境，使用以下命令启动 Cloud SQL Auth 代理：

./cloud-sql-proxy INSTANCE_CONNECTION_NAME

在 Windows 中的 PowerShell 中，使用以下命令启动 Cloud SQL Auth 代理：

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

系统会显示类似以下内容的消息：

Listening on 127.0.0.1:1433 for INSTANCE_CONNECTION_NAME
Ready for new connections

运行以下命令，将 USER_NAME 替换为您的 SQL Server 用户名。

sqlcmd -S 127.0.0.1 -U USER_NAME

返回到您启动了 Cloud SQL Auth 代理的终端窗口。您应该会看到如下所示的消息：

New connection for myInstance

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

1. 在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

   转到“Cloud SQL 实例”

2. 选择 myinstance 实例以打开实例详情页面。
3. 在页面顶部的图标栏中，点击删除。
4. 在删除实例窗口中，输入实例的名称，然后点击删除。

可选的清理步骤

如果您没有使用在本快速入门中启用的 API，则可以将其停用。

• 在本快速入门中启用的 API：
  • Cloud SQL Admin API

1. 在 Google Cloud 控制台中，转到 API 页面。

   转到“API”

2. 选择 Cloud SQL Admin API，然后点击停用 API 按钮。

后续步骤

• 了解如何排查 Cloud SQL Auth 代理的信息。

• 详细了解 Cloud SQL Auth 代理。