使用查询编辑器 - Amazon Aurora
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

使用查询编辑器

利用查询编辑器,您可以在 RDS 控制台中运行 SQL 查询。您可以在 数据库集群上运行任何有效的 SQL 语句,包括数据操作和数据定义语句。

查询编辑器要求 Aurora 数据库集群已启用 RDS 数据 API(数据 API)。有关支持数据 API 的数据库集群以及如何启用它的信息,请参阅使用 RDS 数据 API

查询编辑器的可用性

查询编辑器可用于 Aurora 数据库集群,这些集群使用支持数据 API 的 Aurora MySQL 和 Aurora PostgreSQL 引擎版本,并位于提供数据 API 的 Amazon Web Services 区域中。有关更多信息,请参阅RDS 数据 API

授予对查询编辑器的访问权限

用户必须获得在查询编辑器中运行查询的授权。您可以通过向用户添加 AmazonRDSDataFullAccess 策略(预定义的 Amazon Identity and Access Management(IAM)策略)来授予该用户在查询编辑器中运行查询的权限。

注意

请确保您在创建用户时使用的用户名和密码与为数据库用户所使用的用户名和密码相同,例如主用户名和密码。有关更多信息,请参阅《Amazon Identity and Access Management 用户指南》中的在您的 Amazon Web Services 账户中创建 IAM 用户

您还可以创建 IAM 策略,授予对查询编辑器的访问权限。在创建策略后,将该策略附加到需要对查询编辑器的访问权限的每个用户。

以下策略提供用户访问查询编辑器所需的最低权限。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QueryEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue", "secretsmanager:PutResourcePolicy", "secretsmanager:PutSecretValue", "secretsmanager:DeleteSecret", "secretsmanager:DescribeSecret", "secretsmanager:TagResource" ], "Resource": "arn:aws:secretsmanager:*:*:secret:rds-db-credentials/*" }, { "Sid": "QueryEditor1", "Effect": "Allow", "Action": [ "secretsmanager:GetRandomPassword", "tag:GetResources", "secretsmanager:CreateSecret", "secretsmanager:ListSecrets", "dbqms:CreateFavoriteQuery", "dbqms:DescribeFavoriteQueries", "dbqms:UpdateFavoriteQuery", "dbqms:DeleteFavoriteQueries", "dbqms:GetQueryString", "dbqms:CreateQueryHistory", "dbqms:UpdateQueryHistory", "dbqms:DeleteQueryHistory", "dbqms:DescribeQueryHistory", "rds-data:BatchExecuteStatement", "rds-data:BeginTransaction", "rds-data:CommitTransaction", "rds-data:ExecuteStatement", "rds-data:RollbackTransaction" ], "Resource": "*" } ] }

有关创建 IAM 策略的更多信息,请参阅 Amazon Identity and Access Management 用户指南中的创建 IAM 策略

有关将 IAM 策略添加到用户的信息,请参阅 Amazon Identity and Access Management 用户指南中的添加和删除 IAM 身份权限

在查询编辑器中运行查询

您可以在查询编辑器中对 Aurora 数据库集群运行 SQL 语句。您可以运行的 SQL 受数据 API 限制的约束。有关更多信息,请参阅RDS 数据 API 的限制

在查询编辑器中运行查询
  1. 登录 Amazon Web Services Management Console 并通过以下网址打开 Amazon RDS 控制台:https://console.aws.amazon.com/rds/

  2. 在 Amazon Web Services Management Console的右上角,选择在其中创建了您要查询的 Aurora 数据库集群的 Amazon Web Services 区域。

  3. 在导航窗格中,选择 Databases (数据库)

  4. 选择要对其运行 SQL 查询的 Aurora 数据库集群。

  5. 对于 Actions (操作),选择 Query (查询)。如果您之前未连接到数据库,则 Connect to database (连接到数据库) 页面将打开。

    
                            查询编辑器的“Connect to database (连接到数据库)”页面
  6. 输入以下信息:

    1. 对于数据库实例或集群,选择要对其运行 SQL 查询的 Aurora 数据库集群。

    2. 对于 Database username (数据库用户名),选择要连接的数据库用户的用户名,或者选择 Add new database credentials (添加新的数据库凭证)。如果选择 Add new database credentials (添加新的数据库凭证),请在 Enter database username (输入数据库用户名) 中为新的数据库凭证输入用户名。

    3. 对于 Enter database password (输入数据库密码),请为您选择的数据库用户输入密码。

    4. 在最后一个框中,输入要用于 Aurora 数据库集群的数据库或架构的名称。

    5. 选择 Connect to database (连接到数据库)

      注意

      如果连接成功,则连接和身份验证信息将存储在 Amazon Secrets Manager 中。您无需再次输入连接信息。

  7. 在查询编辑器中,输入要在数据库上运行的 SQL 查询。

    
                            查询编辑器

    每个 SQL 语句可自动提交,或者您可以在脚本中将 SQL 语句作为事务的一部分运行。要控制此行为,请选择查询窗口上方的齿轮图标。

    
                            查询编辑器中的齿轮图标

    将显示 Query Editor Settings (查询编辑器设置) 窗口。

    
                            Query Editor Settings (查询编辑器设置)

    如果您选择 Auto-commit (自动提交),则将自动提交每个 SQL 语句。如果选择事务,则可以在脚本中运行一组语句。语句会在脚本结束时自动提交,除非在此之前已明确提交或回滚。此外,您可以启用 Stop on error (错误时停止),选择当发生错误时停止正在运行的脚本。

    注意

    在一组语句中,数据定义语言 (DDL) 语句可能会造成前面的数据操作语言 (DML) 语句提交。您还可以将 COMMITROLLBACK 语句包含在脚本中的一组语句中。

    Query Editor Settings (查询编辑器设置) 窗口中完成选择后,选择 Save (保存)

  8. 选择 Run (运行) 或按 Ctrl+Enter,查询编辑器将显示查询的结果。

    运行查询后,选择 Save (保存) 将其保存到 Saved queries (保存的查询)

    选择 Export to csv (导出到 CSV),将查询结果导出为电子表格格式。

您可以查找、编辑以及重新运行之前的查询。为此,请选择 Recent (最近)Saved queries (保存的查询) 选项卡,选择查询文本,然后选择 Run (运行)

要更改数据库,请选择 Change database (更改数据库)