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

# 在协作中分析数据
<a name="analyze-data"></a>

在中 AWS Clean Rooms，您可以通过运行查询或作业来分析数据。

*查询*是一种使用一组支持的函数、类和变量在协作中访问和分析已配置表的方法。中当前支持的查询语言 AWS Clean Rooms 是 SQL。有 3 种方法可以运行查询 AWS Clean Rooms：编写 SQL 代码、使用经批准的 SQL 分析模板或使用分析生成器用户界面。

*作业*是一种使用一组支持的函数、类和变量在协作中访问和分析已配置表的方法。中当前支持的作业类型 AWS Clean Rooms 是 PySpark。有一种方法可以运行作业 AWS Clean Rooms：使用经批准的 PySpark 分析模板。

以下主题介绍如何 AWS Clean Rooms 通过运行 SQL 查询或 PySpark作业来分析中的数据。

**Topics**
+ [运行 SQL 查询](running-sql-queries.md)
+ [正在运行的 PySpark 作业](run-jobs.md)

# 运行 SQL 查询
<a name="running-sql-queries"></a>

**注意**  
只有当负责支付查询计算费用的成员以活跃成员的身份加入协作时，您才能运行查询。

作为[可以查询的成员，您可以](glossary.md#glossary-member-who-can-query)通过以下方式运行 SQL 查询：
+ 使用 SQL 代码编辑器手动构建 SQL 查询。
+ 使用经批准的 SQL [分析模板](create-analysis-template.md)。
+ 使用**分析生成器用户界面**无需编写 SQL 代码即可生成查询。

当可以查询的成员对协作中的表运行 SQL 查询时， AWS Clean Rooms 将扮演相关角色来代表他们访问这些表。 AWS Clean Rooms 根据需要将分析规则应用于输入查询及其输出。

分析规则和输出约束是自动强制执行的。 AWS Clean Rooms 仅返回符合定义的分析规则的结果。

AWS Clean Rooms 支持可能与其他查询引擎不同的 SQL 查询。有关规范，请参阅 [AWS Clean Rooms SQL 参考](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)。如果要对受差别隐私保护的数据表运行查询，您应该确保查询与 AWS Clean Rooms Differential Privacy 的[通用查询结构](analysis-rules-custom.md#dp-query-structure-syntax)兼容。

**注意**  
使用 [Clean Rooms 加密计算](crypto-computing.md)时，并非所有 SQL 操作都会生成有效的结果。例如，您可以对加密列执行 COUNT，但是对加密的数字执行 SUM 会导致错误。此外，查询还可能产生错误的结果。例如，SUM 密封列的查询会产生错误。但是，对密封列的 GROUP BY 查询似乎成功了，但生成的组与通过对 cleartext 的 GROUP BY 查询生成的组不同。

[为查询计算费用付费的成员](glossary.md#glossary-member-paying-for-query-compute)要对协作中运行的查询付费。

可以查询的[成员可以选择多个可以接收结果的成员](glossary.md#glossary-member-who-can-receive-results)，以接收来自单个查询的结果。有关更多信息，请参阅 [使用 SQL 代码编辑器查询配置表](use-sql-editor.md)。有关接收查询结果的一般信息，请参见[接收和使用分析结果](receive-query-results.md)。

## 先决条件
<a name="sql-queries-prereqs"></a>

 在运行 SQL 查询之前，请确保具备以下条件：
+  AWS Clean Rooms 合作中的活跃会员
+ 访问协作中至少一个已配置的表
+ 确认负责查询计算成本的成员是活跃的协作成员

有关如何通过直接调用 AWS Clean Rooms [StartProtectedQuery API](https://docs.aws.amazon.com/clean-rooms/latest/apireference/API_StartProtectedQuery.html) 操作或使用来查询数据或查看查询的信息 AWS SDKs，请参阅 [AWS Clean Rooms API 参考](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)。

有关查询日志记录的信息，请参阅[分析登录 AWS Clean Rooms](query-logs.md)。

**注意**  
如果您对[加密](glossary.md#glossary-encryption)数据表运行查询，则加密列的结果将被加密。

## SQL 查询的 Spark 属性配置
<a name="spark-properties-config"></a>

AWS Clean Rooms 使您可以选择通过为 SQL 查询配置支持的 Spark 属性来自定义 Spark 运行时行为。这些属性允许您微调性能、内存使用情况和查询执行参数。借助此功能，您可以更好地控制基于 Spark 的查询的处理方式，从而可以根据您的特定工作负载要求进行优化。

现在，您可以直接从 AWS Clean Rooms 控制台调整诸如随机分区、广播加入阈值和自适应查询执行参数之类的设置。此功能对于复杂的查询或大型数据集特别有用，其中默认配置可能不是最佳配置。通过微调这些 Spark 属性，您可以提高查询性能、减少资源消耗，并更好地管理基于 Spark 的协作分析的内存使用情况。

要利用此功能，你可以在查询界面中找到一个新的 **Spark 属性**部分。您可以从支持的属性列表中进行选择并指定自定义值。您也可以使用 [StartProtectedQuery API](https://docs.aws.amazon.com/clean-rooms/latest/apireference/API_StartProtectedQuery.html) 以编程方式配置 Spark 属性。这种高级配置选项使数据分析师和工程师能够优化查询，从而提高效率和可扩展性。

有关 Spark 属性的更多信息，包括默认值，请参阅 Apache [Spark 文档中的 Spark 属性](https://spark.apache.org/docs/latest/configuration.html#spark-properties)。

以下主题介绍如何使用 AWS Clean Rooms 控制台在协作中查询数据。

**Topics**
+ [先决条件](#sql-queries-prereqs)
+ [SQL 查询的 Spark 属性配置](#spark-properties-config)
+ [使用 SQL 代码编辑器查询配置表](use-sql-editor.md)
+ [使用 SQL 代码编辑器查询 ID 映射表](query-id-mapping-tables.md)
+ [使用 SQL 分析模板查询已配置的表](use-analysis-template.md)
+ [使用分析构建器查询](query-data-analysis-builder.md)
+ [查看差别隐私的影响](query-data-with-diff-privacy.md)
+ [查看最近的查询](view-queries-console.md)
+ [查看查询详细信息](view-query-details.md)

# 使用 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)。

# 使用 SQL 代码编辑器查询 ID 映射表
<a name="query-id-mapping-tables"></a>

以下过程介绍了如何在 ID 映射表上运行多表联接查询，以将 `sourceId` 与 `targetId` 联接。

在查询 ID 映射表之前，必须成功填充 ID 映射表。

**使用 SQL 代码编辑器查询 ID 映射表**

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

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

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

1. 在 “**分析**” 选项卡上，转到 “**分析**” 部分。
**注意**  
只有在可以接收结果的成员和负责支付查询计算费用的成员作为活跃成员加入协作时，才会显示**分析**部分。

1. 在 “**分析**” 选项卡的 “**表**” 下，查看 ID 映射表列表（在 “**管理者” 下 AWS Clean Rooms**）及其关联的分析规则类型（**ID 映射表分析规则**）。
**注意**  
如果您没有在列表中看到所需 ID 映射表，可能是由于 ID 映射表没有成功填充。有关更多信息，请参阅 [填充现有 ID 映射表](populate-id-mapping-table.md)。

1. 通过在 SQL 代码编辑器中键入查询来构建查询。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/query-id-mapping-tables.html)

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

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

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

1. 查看**结果**。

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

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

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

# 使用 SQL 分析模板查询已配置的表
<a name="use-analysis-template"></a>

此过程演示如何使用 AWS Clean Rooms 控制台中的分析模板通过**自定义**分析规则查询已配置的表。

**使用 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. SQL 分析模板中的参数将自动填充到**定义**中。

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

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

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-analysis-template.html)

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

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

# 使用分析构建器查询
<a name="query-data-analysis-builder"></a>

您无需编写 SQL 代码即可使用分析构建器来构建查询。使用分析构建器，您可以为具有以下特征的协作构建查询：
+ 单个使用[聚合分析规则](analysis-rules-aggregation.md)且不需要 JOIN 的表
+ 两个使用[聚合分析规则](glossary.md#glossary-agg-analysis-rule)的表（每个成员一个）
+ 两个使用[列表分析规则](glossary.md#glossary-list-analysis-rule)的表（每个成员一个）
+ 两个使用聚合分析规则的表（每个成员一个）和两个使用列表分析规则的表（每个成员一个）

如果要手动编写 SQL 查询，请参阅[使用 SQL 代码编辑器查询配置表](use-sql-editor.md)。

分析生成器在 AWS Clean Rooms 控制台的 “**分析” 选项卡的 “**分析**” 部分中显示为 “**分析**生成器” 用户界面**选项。

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

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

以下主题介绍分析构建器的使用。

**Topics**
+ [使用分析构建器查询单个表（聚合）](#use-analysis-builder-one-table)
+ [使用分析构建器查询两个表（聚合或列表）](#use-analysis-builder-two-tables)

## 使用分析构建器查询单个表（聚合）
<a name="use-analysis-builder-one-table"></a>

此过程演示如何使用 AWS Clean Rooms 控制台中的 Analys **is Builder 用户界面**来生成查询。该查询适用于具有单个表的协作，该表使用[聚合分析规则](analysis-rules-aggregation.md)且无需 JOIN。

**使用分析构建器查询单个表**

登录 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. 构建查询。

   如果要查看所有聚合指标，请跳至步骤 9。

   1. 对于**选择指标**，请查看默认情况下预先选择的聚合指标，并在需要时删除任何指标。

   1. （可选）对于**添加分段 - 可选**，请选择一个或多个参数。
**注意**  
只有在为表指定维度时才会显示**添加分段 - 可选**。

   1. （可选）对于**添加筛选条件 - 可选**，请选择**添加筛选条件**，然后选择**参数**、运算符和**值**。

      要添加更多筛选条件，请选择**再添加一个筛选条件**。

      要删除筛选条件，请选择**移除**。
**注意**  
ORDER BY 不支持聚合查询。  
筛选条件仅支持 AND 运算符。

   1. （可选）对于**添加描述 - 可选**，请输入描述以帮助识别查询列表中的查询。

1. 展开**预览 SQL 代码**。

   1. 查看分析构建器生成的 SQL 代码。

   1. 要复制 SQL 代码，请选择**复制**。

   1. 要编辑 SQL 代码，请选择**在 SQL 代码编辑器中编辑**。

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

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

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

## 使用分析构建器查询两个表（聚合或列表）
<a name="use-analysis-builder-two-tables"></a>

此过程介绍如何使用 AWS Clean Rooms 控制台中的分析生成器为具有以下特征的协作生成查询：
+ 两个使用[聚合分析规则](analysis-rules-aggregation.md)的表（每个成员一个）
+ 两个使用[列表分析规则](analysis-rules-list.md)的表（每个成员一个）
+ 两个使用聚合分析规则的表（每个成员一个）和两个使用列表分析规则的表（每个成员一个）

**使用分析构建器查询两个表**

登录 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. 构建查询。

   如果协作包含两个使用**聚合分析规则**的表和两个使用**列表分析规则**的表，请先选择**聚合**或**列表**，然后根据所选分析规则按照提示进行操作。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/query-data-analysis-builder.html)

1. 展开**预览 SQL 代码**。

   1. 查看分析构建器生成的 SQL 代码。

   1. 要复制 SQL 代码，请选择**复制**。

   1. 要编辑 SQL 代码，请选择**在 SQL 代码编辑器中编辑**。

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

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

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

# 查看差别隐私的影响
<a name="query-data-with-diff-privacy"></a>

一般来说，在开启差别隐私后，编写和运行查询不会发生变化。不过，如果剩余的隐私预算不足，则无法运行查询。在您运行查询并使用隐私预算时，您可以大致了解可以运行的聚合数量以及这可能会如何影响将来的查询。

**查看差别隐私在协作中的影响**

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

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

1. 选择**您的成员详细信息**状态为**运行查询**的协作。

1. 在 “**分析**” 选项卡的 “**表**” 下，查看剩余的隐私预算。这显示为估计的**剩余聚合函数**数量和**使用的效用**（显示为百分比）。
**注意**  
仅为可以查询的成员显示估计的**剩余聚合函数**数量和**使用的效用**百分比。

1. 选择**查看影响**以查看在结果中注入了多少噪声以及您大约可以运行多少个聚合函数。

# 查看最近的查询
<a name="view-queries-console"></a>

您可以在 “**分析**” 选项卡上查看过去 90 天内运行的查询。

**注意**  
如果您唯一的成员权限是 Contrib **ute 数据**，而您不是[支付查询计算费用的会员](glossary.md#glossary-member-paying-for-query-compute)，则控制台上不会显示 “**分析**” 选项卡。

**查看最近的查询**

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

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

1. 选择协作。

1. 在 “**分析**” 选项卡的 “**分析**” 下，从下拉列表中选择 “**所有查询**”，然后查看过去 90 天内运行的查询。

1. 要按**状态**对最近的查询进行排序，请从**所有状态**下拉列表中选择一个状态。

   状态为：**已提交**、**已开始**、**已取消**、**成功**、**失败**和**超时**。

# 查看查询详细信息
<a name="view-query-details"></a>

您可以以能够运行查询的成员或能够接收结果的成员的身份查看查询的详细信息。

**查看查询的详细信息**

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

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

1. 选择协作。

1. 在 “**分析**” 选项卡上，执行以下任一操作：
   + 选择要查看的特定查询对应的选项按钮，然后选择**查看详细信息**。
   + 选择**受保护的查询 ID**。

1. 在**查询详细信息**页面上，
   + 如果您是可以运行查询的成员，请查看**查询详细信息**、**SQL 文本**和**结果**。

     您会看到一条消息，确认查询结果已发送给可以接收结果的成员。
   + 如果您是可以接收结果的成员，请查看**查询详细信息**和**结果**。

# 正在运行的 PySpark 作业
<a name="run-jobs"></a>

作为[可以查询的成员](glossary.md#glossary-member-who-can-query)，您可以使用已批准的 PySpark [分析模板](create-analysis-template.md)在已配置的表上运行 PySpark 作业。

**先决条件**

 在运行 PySpark 作业之前，你必须：
+  AWS Clean Rooms 合作中的活跃会员
+ 在协作中至少访问一个分析模板
+ 访问协作中至少一个已配置的表
+ 将 PySpark 任务结果写入指定 S3 存储桶的权限

  有关创建所需服务角色的信息，请参阅[创建服务角色以写入 PySpark 作业结果](setting-up-roles.md#create-role-pyspark-job)。
+ 负责支付计算费用的成员已作为活跃成员加入协作

有关如何通过直接调用 AWS Clean Rooms `StartProtectedJob` API 操作或使用来查询数据或查看查询的信息 AWS SDKs，请参阅 [AWS Clean Rooms API 参考](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)。

有关作业记录的信息，请参阅[分析登录 AWS Clean Rooms](query-logs.md)。

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

以下主题说明了如何使用 AWS Clean Rooms 控制台在协作中对已配置的表运行 PySpark 作业。

**Topics**
+ [使用 PySpark 分析模板在已配置的表上运行 PySpark 作业](run-jobs-with-analysis-template.md)
+ [查看最近的工作](view-recent-jobs.md)
+ [查看任务详细信息](view-job-details.md)

# 使用 PySpark 分析模板在已配置的表上运行 PySpark 作业
<a name="run-jobs-with-analysis-template"></a>

此过程演示如何使用 AWS Clean Rooms 控制台中的 PySpark 分析模板通过**自定义**分析规则分析已配置的表。

**使用 PySpark 分析模板在已配置的表上运行 PySpark 作业**

登录 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. 从 “ PySpark 分析模板” 下拉列表中选择**分析模板**。

    PySpark 分析模板中的参数将自动填充到**定义**中。

1. 如果分析模板定义了参数，请在 “**参数**” 下提供参数值：

   1. 查看每个参数的**参数名称**和**默认值**（如果已配置）。

   1. 为要覆盖的每个参数输入一个**值**。
**注意**  
如果您未提供值但存在默认值，则将使用默认值。
**重要**  
参数值最多可包含 1,000 个字符，并且支持 UTF-8 编码。所有参数值都被视为字符串，并通过上下文对象传递给您的用户脚本。  
确保您的用户脚本能够安全地验证和处理参数值。有关安全参数处理的更多信息，请参阅[使用 PySpark 分析模板中的参数](pyspark-parameter-handling.md)。

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

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

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

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

# 查看最近的工作
<a name="view-recent-jobs"></a>

您可以在**分析**选项卡上查看过去 90 天内运行的作业。

**注意**  
如果您唯一的成员权限是 Contrib **ute 数据**，而您不是[支付工作计算费用的会员](glossary.md#glossary-member-paying-for-query-compute)，则控制台上不会显示 “**分析**” 选项卡。

**查看最近的工作**

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

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

1. 选择协作。

1. 在 “**分析**” 选项卡的 “**分析**” 下，从下拉列表中选择 “**所有**作业”，然后查看过去 90 天内运行的作业。

1. 要按**状态**对最近的作业进行排序，请从 “**所有状态” 下拉列表中选择一个状态**。

   状态为：**已提交**、**已开始**、**已取消**、**成功**、**失败**和**超时**。

# 查看任务详细信息
<a name="view-job-details"></a>

您可以以可以运行作业的成员或可以接收结果的成员的身份查看作业详细信息。

**查看任务的详细信息**

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

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

1. 选择协作。

1. 在 “**分析**” 选项卡的 “**分析**” 下，从下拉列表中选择 “**所有作业**”，然后执行以下操作之一：
   + 选择要查看的特定作业的选项按钮，然后选择 “**查看详细信息**”。
   + 选择**受保护的作业 ID**。

1. 在 **Job 详情**页面上，
   + 如果您是可以运行作业的成员，请查看 **Job 详细信息**、**Job** 和**结果**。

     您会看到一条消息，确认工作结果已发送给可以接收结果的成员。
   + 如果您是可以接收结果的成员，请查看 **Job 详情**和**结果**。