使用 Cloud SQL Studio 管理数据

MySQL   |  PostgreSQL   |  SQL Server

本页面介绍如何在 Google Cloud 控制台中使用 Cloud SQL Studio 探索和管理 Cloud SQL 数据。

借助 Cloud SQL Studio，已获授权的用户可直接与 SQL 数据库交互，并从 Google Cloud 控制台运行 SQL 查询来访问和操作数据。您可以执行会在 SQL 命令行客户端上执行的一系列操作，例如创建表和索引、修改表或设置视图。

Cloud SQL Studio 包含一个与查询编辑器和 SQL 查询结果表集成的探索器窗格。您可以从这一个界面运行 DDL、DML 和 DQL 语句。例如，您可以使用 Cloud SQL Studio 中的查询编辑器来创建表并查询数据，而不是配置第三方数据库查询工具。

您可以使用探索器窗格查看数据库对象并与之交互。 您可以创建、修改和删除以下这类数据库对象：

• 表
• 列
• 索引和键
• 函数

您还可以使用探索器窗格为针对表的 SELECT 查询设定种子。

注意：INFORMATION_SCHEMA 架构中的系统级视图为只读视图。

如果您是刚接触 Cloud SQL，请参阅 Cloud SQL 概览。

所需的角色和权限

注意：使用数据库中的 Gemini 时，具有广泛数据库访问权限的用户可能会遇到数据丢失的情况。使用 Gemini in Databases 时，我们建议您使用具有较少数据库权限的账号。

如需获得完成本文档中的任务所需的权限，请让您的管理员为您授予项目的 Cloud SQL Studio User (roles/cloudsql.studioUser) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需使用 Cloud SQL Studio，您必须拥有以下权限：

• cloudsql.databases.list
• cloudsql.instances.executeSql
• cloudsql.instances.get
• cloudsql.instances.login（仅当您使用 IAM 数据库身份验证时才需要）
• cloudsql.users.list

此外，请确保您对用于身份验证的数据库拥有数据库级权限，并且拥有您使用的特权数据库用户的密码。

向 Cloud SQL Studio 进行身份验证

您必须先选择数据库身份验证方法，然后才能在 Cloud SQL Studio 中访问数据库。如需使用 Cloud SQL Studio 登录数据库，您可以使用以下任一类型的身份验证：

• IAM 数据库身份验证。使用此类身份验证后，您无需管理额外的密码，即可登录数据库和 Cloud SQL Studio。 您还可以利用 IAM 群组身份验证，同时管理贵组织中多个用户的数据库访问权限和权限。

• 内置数据库身份验证。 您可以使用 MySQL 用户账号和凭据在 Cloud SQL Studio 中连接到数据库。

探索数据

如需访问探索器窗格，请按照以下步骤操作：

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

   转到“Cloud SQL 实例”

2. 从列表中选择一个实例。
3. 在导航菜单中，点击 Cloud SQL Studio。
4. 使用您的数据库名称、用户名和密码登录 Cloud SQL Studio。探索器窗格会显示数据库中的对象列表。

创建、修改和查询数据

使用 SQL 编辑器，您可以运行 DDL、DML 和 DQL 语句的组合。您可以自行编写查询，也可以使用探索器通过模板填充查询编辑器。

如需构建、修改或查询数据，请按以下步骤操作：

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

   转到“Cloud SQL 实例”

2. 从列表中选择一个实例。
3. 在导航菜单中，点击 Cloud SQL Studio。
4. 使用您的数据库名称、用户名和密码登录 Cloud SQL Studio。
5. 使用以下某个方法编写查询：
   • 如需自行编写查询，请按以下步骤操作：
     1. 点击 即可打开新标签页。
     2. 在查询编辑器出现时，编写查询。
   • 如需根据模板编写查询，请按照以下步骤操作：
     1. 在探索器窗格中，点击数据库对象或集合旁边的 more_vert 查看操作。此时会显示一项或多项可用的操作。
     2. 点击一项操作。查询编辑器中会填充模板。
     3. 替换模板中的所有占位符。
6. 使用以下任一方法运行查询：
   • 如需执行查询编辑器中的所有语句，请点击运行。
   • 如需运行特定语句，请选择一个或多个语句，然后点击运行选定的部分。
7. 查询结果会显示在结果标签页中。如果提供了多个结果集，请从所有结果下拉列表中选择一个结果。

限制

• Cloud SQL Studio 支持轻量级查询。超过 10MB 的响应可能会被截断。如果返回部分结果，Cloud SQL Studio 会进行指示。
• 您只能对正在运行的 Cloud SQL 实例运行查询。
• Cloud SQL Studio 不支持外部服务器。
• 处理时间超过五分钟的请求会被取消。对于 Cloud SQL for MySQL 5.6 和 5.7，长时间运行的 DDL 语句超时可能会导致出现无法安全回滚的孤立文件或表。对大型表执行 ALTER TABLE 这类查询时应小心谨慎。
• SQL 脚本执行完成后，Cloud SQL Studio 不会使数据库连接保持打开状态。同样，编辑器标签页不会共享公共会话，每次执行都会启动新会话。
• 当您混合运行 DML、DQL 和 DDL 语句时，系统仅显示 DQL 查询的结果。
• 关闭浏览器或浏览器标签页不会停止 Cloud SQL Studio 中的查询执行。查询将运行，直到完成或超时。

• Cloud SQL Studio 不支持对 BLOB 数据运行 SELECT 查询。如果 SQL 脚本在输出中生成 BLOB 列，则 SQL 脚本会失败并显示错误。
• Cloud SQL for MySQL 客户端命令不受支持，无法在 Cloud SQL Studio 中执行。
• Cloud SQL Studio 不支持 root 用户。
• 即使 Cloud SQL for MySQL 不需要数据库即可连接，Cloud SQL Studio 也始终需要数据库。
• Cloud SQL Studio 不支持使用空密码的用户。
• USE database 仅对活跃查询执行是有状态的，其运作方式与 gcloud CLI 中不同。
• 数据库用户必须拥有从 localhost 进行连接的权限。

• 在运行多个查询并且其中一个查询失败时，系统将返回第一个遇到的错误。错误发生前该批次中的某些语句可能已成功执行。您可以将多个查询封装在一个 transaction 语句中，以防止出现此问题：

  START TRANSACTION;
      YOUR_SQL_STATEMENTS
  COMMIT;
  

  替换以下内容：

  • YOUR_SQL_STATEMENTS：您要在此查询中运行的语句