Cloud Code 支持运行 Cloud SQL Auth 代理,以连接到 Cloud SQL 数据库、查看 Cloud SQL 实例和创建新的数据源。
准备工作
如果您尚未安装 Cloud Code,请安装该工具。
如需创建新的数据源,您可以使用以下任一高级 JetBrains IDE:
IntelliJ Ultimate 或其他包含 Database Tools and SQL 插件(默认处于启用状态)的高级 JetBrains IDE。
DataGrip,独立的数据库管理环境。
您还可以使用其他首选数据库工具(例如 DBeaver、MySQL Workbench 和 SQL Server Management Studio),通过 Cloud Code 提供的本地端口连接到 Cloud SQL 实例。
使用 Cloud SQL Auth 代理连接到 Cloud SQL 数据库
您可以使用 Cloud Code 在 IntelliJ 或其他受支持的 JetBrains IDE 中连接到 Cloud SQL 数据库并查看 Cloud SQL 实例列表。
如需使用 Cloud Code 连接到 Cloud SQL 数据库,请执行以下操作:
在 IDE 中,点击边栏中的 Google Cloud 数据库,或依次点击 View > Tool Windows > Google Cloud 数据库。
如果尚未选择 Google Cloud 项目,请点击选择 Google Cloud 项目,然后按照提示加载 Google Cloud项目。
Google Cloud 项目中的 Cloud SQL 实例显示在 Cloud SQL 下。
如需连接到 Cloud SQL 实例,请右键点击实例,然后选择使用 Cloud SQL 代理连接。您还可以选择使用专用 IP,方法是选择使用 Cloud SQL 代理(专用 IP)连接。
如需详细了解如何连接到 SQL 实例,请参阅连接选项简介。
创建新的数据源
建立 Cloud SQL Auth 代理连接后,系统会显示 Cloud SQL 实例已连接对话框,您可以选择为本地可用的数据库创建新的数据源,或查看现有数据源。
如需创建新的数据源,请选择创建新的数据源。
或者,您也可以右键点击实例,然后选择创建新数据源。
在身份验证字段中,选择一种方法(默认是用户名和密码)。
保存配置。
Cloud Code 会创建一个采用以下格式的新数据源连接:
gcp-project:location:db-instance-name
。您可以开始通过 JetBrains 的数据库工具和 SQL 插件功能或 DataGrip 处理数据库实例。
(可选)如需在 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