MSCK REPAIR TABLE

添加所有分区可能需要一些时间。如果此操作超时，它将处于不完整的状态，其中只有少数分区会被添加到目录中。应在同一个表上运行 MSCK REPAIR TABLE 语句，直到添加所有分区。有关更多信息，请参阅在 Athena 中对数据进行分区。

对于不兼容 Hive 的分区，请使用ALTER TABLE ADD PARTITION加载分区，以便您可以查询数据。

要与 Athena 结合使用的分区位置必须使用 s3 协议（例如，s3://bucket/folder/）。在 Athena 中，当对包含的表运行 MSCK REPAIR TABLE 查询时，使用其他协议的位置（例如，s3a://bucket/folder/）将导致查询失败。

由于 MSCK REPAIR TABLE 同时扫描文件夹及其子文件夹以查找匹配的分区方案，请确保在单独的文件夹层次结构中保留单独表的数据。例如，假设您在 s3://table-a-data 中拥有表 A 的数据，在 s3://table-a-data/table-b-data 中拥有表 B 的数据。如果两个表都按字符串进行分区，MSCK REPAIR TABLE 会将表 B 的分区添加到表 A。为了避免这种情况，请使用单独的文件夹结构，如 s3://table-a-data 和 s3://table-b-data。请注意，此行为与 Amazon EMR 和 Apache Hive 一致。

由于已知问题，当分区值包含冒号（:）字符时（例如，当分区值为一个时间戳时）MSCK REPAIR TABLE 会静默失败。一个解决方法是使用 ALTER TABLE ADD PARTITION。

MSCK REPAIR TABLE 不会添加开头为下划线（_）的分区列名称。要绕过此限制，使用 ALTER TABLE ADD PARTITION。

Amazon Glue 访问权限 - 确保 Amazon Identity and Access Management（IAM）角色具有允许执行 glue:BatchCreatePartition 操作的策略。有关更多信息，请参阅本文后面的在 IAM policy 中允许 glue:BatchCreatePartition。

Amazon S3 访问权限 – 确保角色具有的策略的权限足以访问 Amazon S3，包括 s3:DescribeJob 操作。有关允许哪些 Amazon S3 操作的示例，请参阅 Athena 中对 Amazon S3 存储桶的跨账户访问 中的示例存储桶策略。

Amazon S3 对象键大小写 - 确保 Amazon S3 路径为小写而不是驼峰式大小写（例如，userid 而不是 userId），或者使用 ALTER TABLE ADD PARTITION 指定对象键名称。有关更多信息，请参阅本文后面的更改或重新定义 Amazon S3 路径。

查询超时 – MSCK REPAIR TABLE 最适用于首次创建表或在数据和分区元数据之间存在奇偶校验不确定性的情况。如果您使用 MSCK REPAIR TABLE 以频繁添加新分区(例如，每天添加)并遇到查询超时，请考虑使用 ALTER TABLE ADD PARTITION。

文件系统中缺少分区 - 如果您在 Amazon S3 中手动删除分区，然后运行 MSCK REPAIR TABLE，您可能会收到错误消息文件系统中缺少分区。这是因为 MSCK REPAIR TABLE 不会从表元数据中删除过时的分区。要从表元数据中移除已删除的分区，请运行 ALTER TABLE DROP PARTITION。请注意，SHOW PARTITIONS 将类似地仅列出元数据中的分区，而不是文件系统中的分区。

“NullPointerException name is null（NullPointerException 名称为空）”错误

如果您将 Amazon Glue CreateTable API 操作或 Amazon CloudFormation AWS::Glue::Table 模板创建用于 Athena 的表，而不指定 TableType 属性，然后运行 DDL 查询，如 SHOW CREATE TABLE 或者 MSCK REPAIR TABLE，则您将收到错误消息 FAILED: NullPointerException Name is null（失败：NullPointerException 名称为空）。

要纠正该错误，请为 TableInput TableType 属性指定值，使其作为 Amazon Glue CreateTable API 调用或 Amazon CloudFormation 模板的一部分。TableType 可能的值包括 EXTERNAL_TABLE 或 VIRTUAL_VIEW。

此要求仅适用于使用 Amazon Glue CreateTable API 操作或 AWS::Glue::Table 模板创建表的情形。如果您适用 DDL 语句或 Amazon Glue 爬网程序为 Athena 创建表，则 TableType 属性将自动定义。

创建 Amazon S3 对象键时，请使用小写字母而不是驼峰式大小写：

s3://DOC-EXAMPLE-BUCKET/path/userid=1/

s3://DOC-EXAMPLE-BUCKET/path/userid=2/

s3://DOC-EXAMPLE-BUCKET/path/userid=3/

使用 ALTER TABLE ADD PARTITION 重新定义位置，如以下示例所示：

ALTER TABLE table_name ADD [IF NOT EXISTS]
PARTITION (userId=1)
LOCATION 's3://DOC-EXAMPLE-BUCKET/path/userId=1/'
PARTITION (userId=2)
LOCATION 's3://DOC-EXAMPLE-BUCKET/path/userId=2/'
PARTITION (userId=3)
LOCATION 's3://DOC-EXAMPLE-BUCKET/path/userId=3/'