连接到 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 数据库,或点击查看 > 工具窗口 > Google Cloud 数据库

  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. 要创建新的数据源,请选择创建新数据源

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

    “数据源和驱动程序”对话框

  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 中提交反馈或报告问题,请依次前往工具 > Cloud Code > 帮助 / 关于 > 提交反馈或报告问题,以在 GitHub 上报告问题,或者在 Stack Overflow 上提问。