本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 SQL 代码编辑器查询配置表
<a name="use-sql-editor"></a>

作为可以查询的成员，您可以通过在 SQL 代码编辑器中编写 SQL 代码来手动生成查询。SQL 代码编辑器位于 AWS Clean Rooms 控制台中 “**分析**” 选项卡的 “**分析**” 部分。

默认情况下显示 SQL 代码编辑器。如果要使用分析构建器来生成查询，请参阅[使用分析构建器查询](query-data-analysis-builder.md)。

**重要**  
如果您开始在代码编辑器中编写 SQL 查询，然后打开**分析构建器用户界面**，则不会保存您的查询。

AWS Clean Rooms 支持许多 SQL 命令、函数和条件。有关更多信息，请参阅 [AWS Clean Rooms SQL 参考](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)。

**提示**  
如果查询运行时发生计划的维护，查询会终止并回滚。必须重新开始查询。

**使用 SQL 代码编辑器查询配置表**

1. 登录 AWS 管理控制台 并在 [https://console.aws.amazon.com/clean](https://console.aws.amazon.com/cleanrooms/home) room AWS Clean Rooms s 上打开控制台。

1. 在左侧导航窗格中，选择**协作**。

1. 选择**您的成员能力**状态为**运行查询**的协作。

1. 在**分析**选项卡的**表格**下，查看表列表及其关联的分析规则类型（**聚合分析规则**、**列表分析规则**或**自定义分析规则**）。
**注意**  
如果您没有在列表中看到所期望的表，可能是由于以下原因：  
这些表尚未[关联](associate-configured-table.md)。
这些表没有[配置分析规则](add-analysis-rule.md)。

1. （可选）要查看表的架构和分析规则控制，请选择加号图标 (**\$1**) 展开表。

1. 在 “**分析**” 部分下，在 “**分析” 模式下**，选择 “编**写 SQL 代码**”。
**注意**  
只有在可以接收结果的成员和负责支付查询计算费用的成员作为活跃成员加入协作时，才会显示**分析**部分。

1. 通过在 SQL 代码编辑器中键入查询来构建查询。

   有关支持的 SQL 命令和函数的更多信息，请参阅 [AWS Clean Rooms SQL 参考。](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)

   您也可以使用以下选项来构建查询。

------
#### [ Use an example query ]

   使用示例查询

   1. 选择表名称旁边的三个垂直点。

   1. 在**在编辑器中插入**下，选择**查询示例**。
**注意**  
插入**示例查询**会将其附加到编辑器中已有的查询中。

      此时将显示查询示例。**表**下列出的所有表都包含在查询中。

   1. 编辑查询中的占位符值。

------
#### [ Insert column names or functions ]

   插入列名或函数

   1. 选择列旁边的三个垂直点。

   1. 在**在编辑器中插入**下，选择**列名**。

   1. 要手动插入列上允许的函数，

      1. 选择列旁边的三个垂直点。

      1. 选择 “**在编辑器中插入**”。

      1. 选择允许的函数的名称（例如INNER JOIN、SUMSUM DISTINCT、或COUNT）。

   1. 按 **Ctrl** \$1 **空格键**可在代码编辑器中查看表架构。
**注意**  
可以查询的成员可以查看和使用每个配置表关联中的分区列。确保将分区列标记为已配置 AWS Glue 表下方的表中的分区列。

   1. 编辑查询中的占位符值。

------

1. 指定支持**的工作器类型**和**工作人员人数**。

   您可以选择运行您的 SQL 查询的实例类型和实例（工作程序）数量。

   对于 CR.1X，您最多可以选择 128 名工作人员或至少 4 名工作人员。

   对于 CR.4X，您最多可以选择 32 名工作人员或至少 4 名工作人员。

   使用下表来确定您的用例所需的工作人员类型和人数。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/use-sql-editor.html)
**注意**  
不同的工作人员类型和人数会产生相关成本。要了解有关定价的更多信息，请参阅[AWS Clean Rooms 定价](https://aws.amazon.com/clean-rooms/pricing/)。

1. 在 “**将结果发送给**” 中，指定谁可以接收结果。
**注意**  
要接收结果，必须将协作成员配置为结果接收者，并且必须是协作的活跃参与者（**状态：活跃**）

1. （仅限可以查询的成员）默认情况下，“**使用您的默认结果设置”** 复选框处于选中状态。如果要保留默认结果设置，请将其选中。

   如果要为此查询指定不同的结果设置，请清除 “**使用默认结果设置”** 复选框，然后选择以下选项。

   1. **结果格式**（**CSV 或 PAR** QU **ET**）

   1. **结果文件**（**单个**或**多个**）

   1. **亚马逊 S3 中的结果目的地**

   每个可以接收结果的成员都可以在 A **mazon S3 中指定不同的**结果格式**、结果**文件**和结果目标**。

1. 要指定 **Spark 属性**：

   1. 展开 **Spark 属性**。

   1. 选择 “**添加 Spark 属性**”。

   1. 在 **Spark 属性**对话框中，从下拉列表中选择一个**属性名称**并输入**值**。

   下表提供了每个属性的定义。

   有关 Spark 属性的更多信息，请参阅 Apache [Spark 文档中的 Spark 属性](https://spark.apache.org/docs/latest/configuration.html#spark-properties)。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/use-sql-editor.html)

1. 选择**运行**。
**注意**  
如果可以接收结果的成员尚未配置查询结果设置，您将无法运行查询。

1. 查看**结果**。

   有关更多信息，请参阅 [接收和使用分析结果](receive-query-results.md)。

1. 继续调整参数并再次运行查询，或者选择 **\$1** 按钮在新选项卡中开始新查询。

**注意**  
AWS Clean Rooms 旨在提供清晰的错误消息。如果错误消息中没有足够的详细信息来帮助您进行故障排除，请联系客户团队。向他们说明错误情况和错误信息（包括任何标识符）。有关更多信息，请参阅 [故障排除 AWS Clean Rooms](troubleshooting.md)。