Cloud SQL Auth 代理使用快速入门

本页面介绍了如何使用 Cloud SQL Auth 代理从本地测试环境连接到 Cloud SQL。通过 Cloud SQL Auth 代理进行连接时,您可以在本地环境中测试 App Engine 应用,或者为数据库管理建立安全连接。

下述说明不适用于为生产环境设置 Cloud SQL Auth 代理。如需了解更多连接方案,请参阅使用 Cloud SQL Auth 代理进行连接

准备工作

在执行本快速入门中的步骤之前,请完成以下任务:

  • 创建 Google Cloud 项目和 Cloud SQL 实例
  • 如果您使用的是现有项目,请确保您的 Google Cloud 用户是项目所有者或具有 IAM Cloud SQL Client 角色。
  • 安装 sqlcmd 客户端。

    该客户端可以是 SQL Server Management Studio (SSMS)Azure Data Studio 或其他客户端。

  • 启用 Admin API

  • 安装 gcloud 命令行工具并进行身份验证。

    1. 如果您尚未安装 gcloud 命令行工具,请先安装。 请参阅 gcloud 安装说明
    2. 初始化 gcloud 工具:
      gcloud init
    3. gcloud 工具进行身份验证:
      gcloud auth login

在本地机器上安装 Cloud SQL Auth 代理客户端

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

获取实例连接名称

  1. 转到“Cloud SQL 实例”页面
  2. 点击实例名称,打开其实例详情页面。
  3. 连接到此实例下,记下实例连接名称

启动 Cloud SQL Auth 代理

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

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

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:1433

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

.\cloud_sql_proxy.exe -instances=INSTANCE_CONNECTION_NAME=tcp:1433

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

Listening on 127.0.0.1:1433 for myproject:myregion:myinstance.
Ready for new connections

使用 sqlcmd 客户端连接到数据库

本部分是可选操作,但我们建议您执行,以便测试您的连接。

如果您安装和配置了 sqlcmd 客户端,则可以通过 IP 地址 127.0.0.1 连接到您的 Cloud SQL 实例,该 IP 地址通过 Cloud SQL Auth 代理的安全连接路由到 Cloud SQL。

通过 SQL Server 客户端连接到 Cloud SQL 实例时,Cloud SQL Auth 代理终端中会出现类似于以下内容的消息:

New connection for "myproject:us-central1:myinstance"

然后,您可以运行查询并执行其他操作。

清理

为避免系统因本快速入门中使用的资源向您的 Google Cloud 帐号收取费用,请按照以下步骤操作。

  1. 转到 Google Cloud Console 中的“Cloud SQL 实例”页面。
    转到“Cloud SQL 实例”页面
  2. 选择 myinstance 实例以打开实例详情页面。
  3. 在页面顶部的图标栏中,点击删除
  4. 删除实例窗口中输入 myinstance,然后点击删除以删除该实例。

    在删除实例后的大约 7 天内,您不能重新使用相应的实例名称。

后续步骤