# 管理工作组
<a name="workgroups-create-update-delete"></a>

在 Athena 控制台（[https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)）中，您可以执行以下任务：




| 语句 | 说明 | 
| --- | --- | 
|  [创建工作组](creating-workgroups.md)  |  创建新的工作组  | 
| [查看工作组详细信息](viewing-details-workgroups.md) | 查看工作组的详细信息，例如其名称、描述、数据使用限制、查询结果位置、预期查询结果存储桶拥有者、加密，以及对写入查询结果存储桶的对象的控制权。如果 Override client-side settings (覆盖客户端设置) 已被选中，您还可以验证该工作组是否已强制实施其设置。 | 
|  [为查询指定工作组](specify-wkgroup-to-athena-in-which-to-run-queries.md)  |  您必须为 Athena 指定要使用的工作组，然后才能运行查询。您必须具有工作组的权限。  | 
|  [切换工作组](switching-workgroups.md)  |  在您有权访问的工作组之间切换。  | 
|  [编辑工作组](editing-workgroups.md)  | 编辑工作组并更改其设置。您不能更改工作组的名称，但您可以创建一个具有相同设置但名称不同的新工作组。 | 
|  [启用或禁用工作组](workgroups-enabled-disabled.md)  |  启用或禁用工作组。当工作组处于禁用状态，其用户无法运行查询或创建新的命名查询。如果您有权访问它，您仍然可以查看指标、数据使用限制控制、工作组设置，查询历史记录和已保存查询。  | 
|  [在工作组之间复制已保存的查询](copy-a-query-between-workgroups.md)  | 在工作组之间复制已保存的查询。例如，如果您在预览工作组中创建了查询，并且希望在非预览工作组中使用该查询，则可能需要执行此操作。 | 
|  [删除工作组](deleting-workgroups.md)  |  删除工作组。如果您删除某个工作组，则查询历史记录、已保存查询、工作组设置和查询数据限制控制都将被删除。工作组范围的数据限制控制会保留在 CloudWatch 中，您可以单独删除它们。 不能删除主工作组。  | 
| [使用 IAM 策略控制工作组访问](workgroups-iam-policy.md) | 使用 IAM 策略控制工作组访问。有关示例工作组策略，请参阅[工作组策略示例](example-policies-workgroup.md)。 | 
| [创建使用 IAM Identity Center 身份验证的 Athena 工作组](workgroups-identity-center.md) | 要在 Athena 中使用 IAM Identity Center 身份，必须创建一个启用了 IAM Identity Center 的工作组。创建工作组后，您可以使用 IAM Identity Center 控制台或 API 将 IAM Identity Center 用户或组分配给工作组。 | 
| [为工作组配置最低加密](workgroups-minimum-encryption.md) | 在 Amazon S3 中对该工作组的所有查询结果强制执行最低级别的加密。使用此功能确保查询结果永远不会以未加密状态存储在 Amazon S3 存储桶中。 | 

# 查看工作组详细信息
<a name="viewing-details-workgroups"></a>

您可以查看每个工作组的详细信息。这些详细信息包括工作组名称、描述、启用还是禁用以及用于在该工作组中运行的查询的设置，其中包括查询结果位置、预期存储桶拥有者、加密，以及对写入查询结果存储桶的对象的控制权。如果工作组具有数据使用限制，也会显示出来。

**查看工作组详细信息**

1. 在 Athena 控制台导航窗格中，选择 **Workgroups**（工作组）。

1. 在 **Workgroups**（工作组）页面上，选择要查看的工作组的链接。显示工作组的 **Overview Details**（概览详细信息）页面。

# 为查询指定工作组
<a name="specify-wkgroup-to-athena-in-which-to-run-queries"></a>

若要指定要使用的工作组，您必须具有该工作组的权限。

**指定要使用的工作组**

1. 确保您的权限允许您在要使用的工作组中运行查询。有关更多信息，请参阅 [使用 IAM 策略控制工作组访问](workgroups-iam-policy.md)。

1.  若要指定工作组，请使用以下选项之一：
   + 如果您正在使用 Athena 控制台，请通过[切换工作组](switching-workgroups.md)设置工作组。
   + 如果您正在使用 Athena API 操作，请在 API 操作中指定工作组名称。例如，您可以在 [StartQueryExecution](https://docs.aws.amazon.com/athena/latest/APIReference/API_StartQueryExecution.html) 中设置工作组名称，如下所示：

     ```
     StartQueryExecutionRequest startQueryExecutionRequest = new StartQueryExecutionRequest()
                   .withQueryString(ExampleConstants.ATHENA_SAMPLE_QUERY)
                   .withQueryExecutionContext(queryExecutionContext)
                   .withWorkGroup(WorkgroupName)
     ```
   + 如果您正在使用 JDBC 或 ODBC 驱动程序，使用 `Workgroup` 配置参数在连接字符串中设置工作组名称。驱动程序将工作组名称传递到 Athena。在连接字符串中指定工作组参数，如以下示例所示：

     ```
     jdbc:awsathena://AwsRegion=<AWSREGION>;UID=<ACCESSKEY>;
     PWD=<SECRETKEY>;S3OutputLocation=s3://amzn-s3-demo-bucket/<athena-output>-<AWSREGION>/;
     Workgroup=<WORKGROUPNAME>;
     ```

# 切换工作组
<a name="switching-workgroups"></a>

如果您具有两个工作组的权限，则可以从一个工作组切换到另一个工作组。

在每个工作组中，您可以打开最多十个查询选项卡。当您在工作组之间切换时，最多可将三个工作组中的查询选项卡保持打开。

**切换工作组**

1. 在 Athena 控制台中，使用右上角的 **Workgroup**（工作组）选项来选择工作组。

1. 如果出现 **Workgroup *workgroup-name* settings**（工作组 workgroup-name 设置）对话框，请选择 **Acknowledge**（确认）。

**Workgroup**（工作组）选项将显示已切换到的工作组名称。现在，您可以运行该工作组中的查询。

# 编辑工作组
<a name="editing-workgroups"></a>

编辑工作组需要具有执行 `UpdateWorkgroup` API 操作的权限。请参阅[配置对工作组和标签的访问](workgroups-access.md)和[使用 IAM 策略控制工作组访问](workgroups-iam-policy.md)。如果要添加或编辑标记，您还需要具有对 `TagResource` 的权限。请参阅[工作组的标签策略示例](tags-access-control.md#tag-policy-examples-workgroups)。

**在控制台中编辑工作组**

1. 在 Athena 控制台导航窗格中，选择 **Workgroups**（工作组）。

1. 在 **Workgroups**（工作组）页面上，选择要编辑的工作组的按钮。

1. 选择 **Actions**（操作）和 **Edit**（编辑）。

1. 根据需要更改字段。有关字段的列表，请参阅[创建工作组](creating-workgroups.md)。您可以更改除工作组名称以外的所有字段。如果您需要更改名称，请创建具有新名称和相同设置的另一工作组。

1. 选择**保存更改**。已更新的工作组显示在 **Workgroups **（工作组）页面上的列表中。

# 启用或禁用工作组
<a name="workgroups-enabled-disabled"></a>

如果您拥有相应的权限，您可以在控制台中、使用 API 操作或者使用 JDBC 和 ODBC 驱动程序启用或禁用工作组。

**启用或禁用工作组**

1. 在 Athena 控制台导航窗格中，选择 **Workgroups**（工作组）。

1. 在 **Workgroups**（工作组）页面上，选择工作组的链接。

1. 在右上角，选择 **Enable workgroup**（启用工作组）或 **Disable workgroup**（禁用工作组）。

1. 在确认提示处，选择 **Enable**（启用）或 **Disable**（禁用）。如果您禁用一个工作组，其用户无法运行其中的查询或创建新的命名查询。如果您启用一个工作组，用户可以使用它来运行查询。

# 在工作组之间复制已保存的查询
<a name="copy-a-query-between-workgroups"></a>

目前，Athena 控制台没有将保存的查询从一个工作组直接复制到另一个工作组的选项，但您可以使用以下过程手动执行相同的任务。

**要在工作组之间复制保存的查询**

1. 在 Athena 控制台中，从您想复制查询的工作组中，选择 **Saved queries**（保存的查询）选项卡。

1. 选择要复制的已保存查询的链接。Athena 会在查询编辑器中打开查询。

1. 在查询编辑器中，选择查询文本，然后按 **Ctrl\$1C** 以复制查询。

1. [切换](switching-workgroups.md)到目标工作组，或[创建工作组](creating-workgroups.md)，然后切换到该工作组。

1. 在查询编辑器中打开一个新选项卡，然后按 **Ctrl\$1V** 将文本粘贴到新选项卡中。

1. 在查询编辑器中，选择 **Save as**（另存为）将查询保存到目标工作组中。

1. 在 **Choose a name**（选择一个名称）对话框中，输入查询名称和可选说明。

1. 选择**保存**。

# 删除工作组
<a name="deleting-workgroups"></a>

如果您具有相应权限，则可以删除工作组。不能删除主工作组。

如果您有权限，则可以随时删除空工作组。您也可以删除包含已保存查询的工作组。在这种情况下，Athena 会警告您保存的查询将被删除，然后再继续删除工作组。

如果您删除正在其中的工作组，控制台会将焦点切换到主工作组。如果您有权访问它，可以运行查询并查看其设置。

如果您删除某个工作组，其设置和查询数据限制控制都将被删除。工作组范围的数据限制控制保留在 CloudWatch 中，您可以在需要时从中删除它们。

**重要**  
在删除工作组之前，确保其用户同时属于其他工作组，从而可以从中继续运行查询。如果用户的 IAM policy *仅*允许他们允许该工作组中的查询，而您删除了它，则他们将不再具有运行查询的权限。有关更多信息，请参阅 [Example policy for running queries in the primary workgroup](example-policies-workgroup.md#example4-run-in-primary-access)。

**在控制台中删除工作组**

1. 在 Athena 控制台导航窗格中，选择 **Workgroups**（工作组）。

1. 在 **Workgroups**（工作组）页面上，选择要删除的工作组的按钮。

1. 依次选择**操作**和**删除**。

1. 在 **Delete workgroup**（删除工作组）确认提示处，输入工作组名称，然后选择 **Delete**（删除）。

要使用 API 操作删除工作组，请使用 `DeleteWorkGroup` 操作。