从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://www.amazonaws.cn/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# 打开查询编辑器 v2
<a name="query-editor-v2-open"></a>

借助 Amazon Redshift，您可以使用 Amazon Redshift 控制台中的查询编辑器 v2 对数据仓库集群执行 SQL 查询。查询编辑器 v2 是一款基于 Web 的工具，为运行临时查询、探索数据和执行数据分析任务提供了友好的用户界面。以下各个部分将指导您完成在控制台中打开查询编辑器 v2 并有效地利用其功能的过程。

**如要打开查询编辑器 v2**

1. 登录到 Amazon Web Services 管理控制台并打开 Amazon Redshift 控制台，网址：[https://console.aws.amazon.com/redshiftv2/](https://console.amazonaws.cn/redshiftv2/)。

1. 在导航器菜单中，选择**编辑器**，然后选择**查询编辑器 V2**。此时将在新的浏览器标签页中打开查询编辑器 v2。

查询编辑器页面有一个导航器菜单，您可以在其中选择视图，如下所示：

**编辑器 ![\[Horizontal lines representing redacted or censored text.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-align-left.png)**  
您可以管理和查询以表形式组织并包含在数据库中的数据。数据库可以包含存储的数据，也可以包含对存储在其他位置（如 Amazon S3）的数据的引用。连接到包含在集群或无服务器工作组中的数据库。  
在**编辑器**视图中工作时，您有以下控件：  
+ **集群**或 **工作组**字段显示您当前连接到的集群或工作组的名称。**数据库**字段显示集群或工作组内的数据库。您在**数据库**视图执行的操作默认会对您选择的数据库执行操作。
+ 集群或工作组、数据库和架构的树视图层次结构视图。在架构下，您可以使用表、视图、函数和存储过程。树视图中的每个对象都支持上下文菜单来执行相关操作，例如对对象进行**刷新**或**删除**。
+ 通过 ![\[The create icon used in the Amazon Console.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-add.png) **创建**操作来创建数据库、架构、表和函数。
+ 通过![\[The upload icon used in the Amazon Console.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-upload.png)**加载数据**操作将数据从 Amazon S3 或从本地文件加载到数据库。
+ 通过 ![\[The floppy disk icon used in the Amazon Console.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-floppy-disk.png) **保存**图标来保存您的查询。
+ 通过 ![\[The shortcut icon used in the Amazon Console.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-key-command.png) **快捷方式**图标来显示编辑器的键盘快捷键。
+ ![\[The more actions icon used in the Amazon Console.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-more.png) **更多**图标，用于在编辑器中显示更多操作。例如：
  + **与我的团队共享**，与您的团队共享查询或笔记本。有关更多信息，请参阅 [以团队形式协作和共享](query-editor-v2-team.md)。
  + **快捷方式**，显示编辑器的键盘快捷键。
  + **选项卡历史记录**，用于在编辑器中显示选项卡的选项卡历史记录。
  + **刷新自动完成**，用于在编写 SQL 时刷新显示的建议。
+ 可以在 ![\[The editor icon in the Amazon Console where can enter and run queries.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/add-plus.png) **编辑器**区域中输入和运行查询。

  运行查询后，**结果**选项卡随即显示结果。您可以打开此处的**图表**来可视化您的结果。还可以**导出**结果。
+ ![\[The icon in the Amazon Console where you can add sections to enter and run SQL or add Markdown.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/add-plus.png) **笔记本**区域，您可以在其中添加各部分，以输入和运行 SQL 或添加 Markdown。

  运行查询后，**结果**选项卡随即显示结果。您可以在此处**导出**结果。

**查询 ![\[A folder icon used in the Amazon Console used to query databases.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-folder-close.png)**  
查询包含用于管理和查询数据库中数据的 SQL 命令。当您使用查询编辑器 v2 加载示例数据时，它还会为您创建和保存示例查询。  
 在选择了某个已保存的查询时，您可以使用上下文菜单（右键单击）打开、重命名和删除该查询。您可以选择**查询详细信息**，查看已保存查询的属性，例如**查询 ARN**。您还可以查看其版本历史记录、编辑附加到查询的标签，并将其与您的团队共享。

**笔记本 ![\[A book icon used in the Amazon Console used as SQL notebook.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-manual.png)**  
SQL 笔记本包含 SQL 和 Markdown 单元格。使用笔记本可在单个文档中组织、注释及共享多个 SQL 命令。  
 在选择了某个已保存的笔记本时，您可以使用上下文菜单（右键单击）打开、重命名、复制和删除该笔记本。您可以选择**笔记本详细信息**，查看已保存笔记本的属性，例如**笔记本 ARN**。您还可以查看其版本历史记录、编辑附加到笔记本的标签，并将其与您的团队共享。有关更多信息，请参阅 [Amazon Redshift 中的笔记本笔记本](query-editor-v2-notebooks.md)。

**图表 ![\[Icon of a chart used in the Amazon Console as visual representation of data.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-chart.png)**  
图表是您的数据的可视化表示。查询编辑器 v2 提供了用于创建多种图表并保存它们的工具。  
 在选择了某个已保存的图表时，您可以使用上下文菜单（右键单击）打开、重命名和删除该图表。您可以选择**图表详细信息**，查看已保存图表的属性，例如 **图表 ARN**。您也可以编辑附加到图表的标签并将其导出。有关更多信息，请参阅 [可视化查询结果](query-editor-v2-charts.md)。

**历史记录 ![\[Icon of a clock used in the Amazon Console for query history.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-clock.png)**  
查询历史记录是您使用 Amazon Redshift 查询编辑器 v2 运行的查询的列表。这些查询作为单个查询运行，或作为 SQL 笔记本的一部分运行。有关更多信息，请参阅 [查看查询和选项卡历史记录](query-editor-v2-history.md)。

**计划查询 ![\[Icon of a calendar used in the Amazon Console for scheduled queries.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-calendar.png)**  
计划查询是设置为在特定时间开始的查询。

 所有查询编辑器 v2 视图都有以下图标：
+ ![\[Icon of a quarter moon used in the Amazon Console to switch between light and dark modes.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-moon.png) **可视化模式**图标，可在亮模式和暗模式之间切换。
+ ![\[Icon of a gear used in the Amazon Console to show settings.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-cog.png) **设置**图标，可显示不同设置屏幕的菜单。
  + ![\[Icon used in the Amazon Console to show editor preferences.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-properties.png) **编辑器首选项**图标，可在使用查询编辑器 v2 时编辑首选项。在此处，您可以**编辑工作区设置**以更改字体大小、选项卡大小和其它显示设置。您也可以打开（或关闭）**自动完成**，以便在输入 SQL 时显示建议。
  + ![\[Icon used in the Amazon Console to view connections used in the editor tab.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-connection.png) **连接**图标，可查看编辑器选项卡使用的连接。

    连接用于检索数据库中的数据。连接是针对特定数据库创建的。使用隔离连接时，在一个编辑器选项卡中更改数据库的 SQL 命令（例如创建临时表）的结果在另一个编辑器选项卡中不可见。在查询编辑器 v2 中打开编辑器选项卡时，默认为隔离连接。创建共享连接时，即关闭**隔离会话**开关，同一数据库的其他共享连接的结果对彼此可见。但是，使用数据库的共享连接的各编辑器选项卡不会并行运行。使用相同连接的查询必须等到连接可用。与一个数据库的连接不能与另一个数据库共享，因此 SQL 结果在不同的数据库连接之间不可见。

    账户中的任何用户可以激活的连接数由查询编辑器 v2 管理员控制。
  + ![\[Icon used in the Amazon Console used by administrators to change settings of user accounts.\]](http://docs.amazonaws.cn/redshift/latest/mgmt/images/qev2-settings.png) **账户设置**图标，管理员用于更改账户中所有用户的某些设置。有关更多信息，请参阅 [账户设置](#query-editor-v2-settings)。

## 使用查询编辑器 v2 时的注意事项
<a name="query-editor-v2-considerations"></a>

使用查询编辑器 v2 时，请注意以下几点。
+ 查询的最长持续时间为 24 小时。
+ 查询结果的最大大小为 100 MB。如果调用返回的响应数据超过 100 MB，则返回前 100 MB 数据并显示警告。
+ 您可以运行最长为 300,000 个字符的查询。
+ 您可以保存最长为 30,000 个字符的查询。
+ 默认情况下，查询编辑器 v2 会自动提交所运行的每个 SQL 命令。当提供 BEGIN 语句时，BEGIN-COMMIT 或 BEGIN-ROLLBACK 块中的语句将作为单个事务运行。有关事务的更多信息，请参阅《Amazon Redshift 数据库开发人员指南》**中的 [BEGIN](https://docs.amazonaws.cn/redshift/latest/dg/r_BEGIN.html)。
+ 运行 SQL 语句时，查询编辑器 v2 显示的最大警告数为 `10`。例如，运行存储过程时，显示的 RAISE 语句不超过 10 个。
+ 查询编辑器 v2 不支持包含逗号（,）的 IAM `RoleSessionName`。您可能会看到类似以下的错误：错误消息：“‘AROA123456789EXAMPLE:mytext,yourtext’不是 TagValue 的有效值 - 它包含非法字符”。当您定义包含逗号的 IAM `RoleSessionName`，然后将查询编辑器 v2 与该 IAM 角色一起使用时，就会出现此问题。

  有关 IAM `RoleSessionName` 的更多信息，请参阅《IAM 用户指南》**中的 [RoleSessionName SAML 属性](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_providers_create_saml_assertions.html#saml_role-session-attribute)。

## 账户设置
<a name="query-editor-v2-settings"></a>

拥有正确 IAM 权限的用户可以查看和更改同一 Amazon Web Services 账户中其他用户的**账户设置**。该管理员可以查看或设置以下内容：
+ 账户中每个用户的最大并发数据库连接数。这包括用于**隔离会话**的连接。更改此值时，更改可能需要 10 分钟才能生效。
+ 允许账户中的用户将整个结果集从 SQL 命令导出到文件中。
+ 加载和显示示例数据库以及一些关联的已保存查询。
+ 指定账户用户用于从本地文件加载数据的 Amazon S3 路径。
+ 查看用于加密查询编辑器 v2 资源的 KMS 密钥 ARN。