查询还原的 Amazon S3 Glacier 对象 - Amazon Athena
注意事项和限制将表配置为使用已还原的对象

查询还原的 Amazon S3 Glacier 对象

您可以使用 Athena 查询从 S3 Glacier Flexible Retrieval（以前称为 Glacier）和 S3 Glacier Deep Archive Amazon S3 存储类还原的对象。必须针对每个表启用此功能。如果您在运行查询之前未在表上启用该功能，Athena 将在查询执行期间跳过该表的所有 S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 对象。

注意事项和限制

  • 只有 Athena 引擎版本 3 支持查询还原的 Amazon S3 Glacier 对象。

  • 只有 Apache Hive 表支持该功能。

  • 在查询数据之前，您必须还原对象；Athena 不会为您还原对象。

将表配置为使用已还原的对象

要将 Athena 表配置为在查询中包含还原的对象，必须将其 read_restored_glacier_objects 表属性设置为 true。为此，您可以使用 Athena 查询编辑器或 AWS Glue 控制台。您还可以使用 AWS Glue CLI、AWS Glue API 或 AWS Glue SDK。

使用 Athena 查询编辑器

在 Athena 中，您可以使用 ALTER TABLE SET TBLPROPERTIES 命令来设置表属性，如下例所示。

ALTER TABLE table_name SET TBLPROPERTIES ('read_restored_glacier_objects' = 'true')

使用 AWS Glue控制台

在 AWS Glue 控制台中，执行以下步骤添加 read_restored_glacier_objects 表属性。

在 AWS Glue 控制台中配置表属性

  1. 登录 AWS Management Console，然后打开 AWS Glue 控制台，网址为：https://console.aws.amazon.com/glue/。

  2. 请执行以下操作之一：

    • 选择转到数据目录。

    • 在导航窗格中，选择数据目录表。

  3. 在表页面的表列表中+，选择要编辑的表的链接。

  4. 依次选择 Actions（操作）、Edit table（编辑表）。

  5. 在编辑表页面的表属性部分中，添加以下键值对：

    • 对于 Key (键)，添加 read_restored_glacier_objects。

    • 对于 Value（值），输入 true。

  6. 请选择保存。

使用 AWS CLI

在 AWS CLI 中，您可以使用 AWS Glue update-table 命令及其 --table-input 参数来重新定义表，并在此过程中添加 read_restored_glacier_objects 属性。在 --table-input 参数中，使用 Parameters 结构来指定 read_restored_glacier_objects 属性和 true 值。请注意：--table-input 的参数不能有空格，并且必须使用反斜杠来转义双引号。在以下示例中，将 my_database 和 my_table 替换为数据库和表的名称。

aws glue update-table \
   --database-name my_database \
   --table-input={\"Name\":\"my_table\",\"Parameters\":{\"read_restored_glacier_objects\":\"true\"}}
重要

AWS Glue update-table 命令在覆盖模式下运行，这意味着其将用 table-input 参数指定的新定义替换现有的表定义。因此，在添加 read_restored_glacier_objects 属性时，请务必在 table-input 参数中指定希望表中包含的所有字段。