Override client-side settings (覆盖客户端设置)
创建或编辑工作组时,您可以选择覆盖客户端设置选项。此选项非默认选定。根据您是否选择它,Athena 会执行以下操作:
-
如果覆盖客户端设置未被选中,则不会在客户端级别强制实施工作组设置。当未为工作组选择覆盖客户端设置选项时,Athena 会将客户端设置用于工作组中运行的所有查询,包括查询结果位置、预期存储桶所有者、加密和写入查询结果存储桶的对象控制的设置。每个用户都可以在控制台的设置菜单中指定自己的设置。如果未设置客户端设置,则会应用工作组范围设置。如果您使用 AWS CLI、API 操作或 JDBC 和 ODBC 驱动程序在不覆盖客户端设置的工作组中运行查询,则您的查询将使用您在查询中指定的设置。
-
如果覆盖客户端设置被选中,则会在工作组级别对工作组中的所有客户端强制实施工作组设置。当为工作组选择覆盖客户端设置选项时,Athena 会将工作组设置用于工作组中运行的所有查询,包括查询结果位置、预期存储桶所有者、加密和写入查询结果存储桶的对象控制的设置。工作组设置会覆盖您在使用控制台、API 操作或 JDBC 或 ODBC 驱动程序时为查询指定的任何客户端设置。在完成工作组设置以覆盖客户端设置后,可以省略在驱动程序或 API 中指定客户端设置的操作。
如果您覆盖客户端设置,则您或任何工作组用户下一次打开 Athena 控制台时,Athena 会通知您该工作组中的查询使用工作组设置,并提示您确认此更改。
注意
由于覆盖客户端设置可能会破坏基于任意 Amazon S3 存储桶中结果可用性的自定义自动化,因此我们建议您在覆盖之前通知用户。
重要
如果您使用 API 操作、AWS CLI 或 JDBC 和 ODBC 驱动程序在覆盖客户端设置的工作组中运行查询,请确保在查询中省略客户端设置或更新它们以匹配工作组的设置。
如果您在查询中指定了客户端设置,但在覆盖设置的工作组中运行这些设置,则查询将运行,但将使用工作组设置。有关查看工作组设置的信息,请参阅 查看工作组详细信息。