连接到 Cloud SQL 数据库

Cloud Code 支持运行 Cloud SQL Auth 代理以连接到 Cloud SQL 数据库、查看 Cloud SQL 实例以及创建新数据源。

准备工作

使用 Cloud SQL Auth 代理连接到 Cloud SQL 数据库

您可以使用 Cloud Code 连接到 Cloud SQL 数据库,并在 IntelliJ 或其他受支持的 JetBrains IDE 中查看 Cloud SQL 实例列表。

如需使用 Cloud Code 连接到 Cloud SQL 数据库,请执行以下操作:

  1. 在 IDE 中,点击边栏中的 Google Cloud Databases,或点击 View > Tool Windows > Google Cloud Databases

  2. 如果尚未选择 Google Cloud 项目,请点击选择 Google Cloud 项目,然后按照提示加载您的 Google Cloud 项目。

    Google Cloud 项目中的 Cloud SQL 实例显示在 Cloud SQL 下。

    Cloud SQL 工具窗口

  3. 如需连接到 Cloud SQL 实例,请右键点击实例,然后选择使用 Cloud SQL 代理连接。您还可以选择使用 Cloud SQL 代理(专用 IP)连接来使用专用 IP。

如需详细了解如何连接到 SQL 实例,请参阅关于连接选项

创建新的数据源

建立 Cloud SQL Auth 代理连接后,系统会显示 Cloud SQL Instance Connected 对话框,可让您选择为本地可用的数据库创建新数据源或查看现有数据源。

  1. 如需创建新的数据源,请选择创建新数据源

    或者,您也可以右键点击实例,然后选择创建新数据源

    “Data Sources and Drivers”(数据源和驱动程序)对话框

  2. Authentication 字段中,选择一种方法(默认情况下,这是用户名和密码)。

  3. 保存配置。

    Cloud Code 会创建一个新的数据源连接,其名称采用以下格式:

    gcp-project:location:db-instance-name.

    您可以通过 JetBrains 的数据库工具和 SQL 插件功能或 DataGrip 来开始使用数据库实例。

  4. (可选)如需在 IDE 中查看数据源列表,请点击边栏中的 Database(数据库),或依次点击 View > Tool Windows > Database。右键点击数据源会向您提供选项列表,例如查看架构、表和其他数据库操作。

    数据库工具选项

    如需详细了解如何在 DataGrip 中使用数据库,请参阅 DataGrip 快速入门

断开 Cloud SQL Auth 代理的连接

如需停止代理进程并释放本地数据库端口,请在终端中按 Ctrl+C

已知问题

本部分列出了所有已知问题及其当前解决方案。

设置其他端口以连接到多个数据库

如果端口繁忙,则 Cloud SQL Auth 代理不会自动选择端口,并且始终依赖于端口,这样您就只能连接到特定类型的数据库的单个连接实例。

Cloud Code 在终端中运行 Cloud SQL Auth 代理,如果遇到端口冲突,您可以使用自定义 --port 标志在终端中运行同一命令,以将其他端口设置为连接到数据库。例如:

--port=PORT_NUMBER

然后,您可以在数据库连接中使用此端口。该命令将自动生成。例如:

path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING

获取支持

如需在 IntelliJ IDE 中提交反馈或报告问题,请依次前往 Tools > Cloud Code > Help / About > Submit feedback or Report an issue,以便在 GitHub 上报告问题,或者在 Stack Overflow 上提问。