本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
表格优化器 API
表优化器API描述了 AWS Glue API如何启用压缩以提高读取性能。
数据类型
TableOptimizer 结构
包含有关与表相关的优化器详细信息。
字段
-
type— UTF -8 字符串（有效值：compaction="COMPACTION"）。优化器的类型。目前唯一有效的值是
compaction。 -
configuration– 一个 TableOptimizerConfiguration 对象。在创建或更新表优化器时指定的
TableOptimizerConfiguration对象。 -
lastRun– 一个 TableOptimizerRun 对象。表示表优化器的上一次运行的
TableOptimizerRun对象。
TableOptimizerConfiguration 结构
包含有关表优化器配置的详细信息。您可以在创建或更新表优化器时传递此配置。
字段
-
roleArn— UTF -8 个字符串，长度不小于 1 或超过 512 字节，与. Single-line string pattern由调用方传递的角色，将向服务授予代表调用方更新与优化器关联的资源的权限。
-
enabled– 布尔值。是否启用表优化。
TableOptimizerRun 结构
包含表优化器运行的详细信息。
字段
-
eventType— UTF -8 字符串（有效值：starting="STARTING"| |completed="COMPLETED"failed="FAILED"|in_progress="IN_PROGRESS"）。一种表示表优化器运行状态的事件类型。
-
startTimestamp– 时间戳。表示在 Lake Formation 中启动压缩作业的纪元时间戳。
-
endTimestamp– 时间戳。表示压缩作业结束的纪元时间戳。
-
metrics– 一个 RunMetrics 对象。包含有关优化器运行的指标的
RunMetrics对象。 -
error— UTF -8 字符串。优化器运行期间出现的错误。
RunMetrics 结构
有关优化器运行的指标。
字段
-
NumberOfBytesCompacted— UTF -8 字符串。由压缩作业运行移除的字节数。
-
NumberOfFilesCompacted— UTF -8 字符串。由压缩作业运行移除的文件数。
-
NumberOfDpus— UTF -8 字符串。任务消耗的DPU小时数。
-
JobDurationInHour— UTF -8 字符串。作业的持续时间（以小时为单位）。
BatchGetTableOptimizerEntry 结构
表示要在 BatchGetTableOptimizer 操作中检索的表优化器。
字段
-
catalogId– 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。表的目录 ID。
-
databaseName— UTF -8 字符串，长度至少 1 个字节。表所在的目录中的数据库的名称。
-
tableName— UTF -8 字符串，长度至少 1 个字节。表的名称。
-
type— UTF -8 字符串（有效值：compaction="COMPACTION"）。优化器的类型。
BatchTableOptimizer 结构
包含 BatchGetTableOptimizer 操作返回的表优化器之一的详细信息。
字段
-
catalogId– 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。表的目录 ID。
-
databaseName— UTF -8 字符串，长度至少 1 个字节。表所在的目录中的数据库的名称。
-
tableName— UTF -8 字符串，长度至少 1 个字节。表的名称。
-
tableOptimizer– 一个 TableOptimizer 对象。包含有关表优化器配置和上次运行的详细信息的
TableOptimizer对象。
BatchGetTableOptimizerError 结构
包含 BatchGetTableOptimizer 操作所返回错误列表中的某一个错误的详细信息。
字段
-
error– 一个 ErrorDetail 对象。包含有关错误代码和错误消息详细信息的
ErrorDetail对象。 -
catalogId– 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。表的目录 ID。
-
databaseName— UTF -8 字符串，长度至少 1 个字节。表所在的目录中的数据库的名称。
-
tableName— UTF -8 字符串，长度至少 1 个字节。表的名称。
-
type— UTF -8 字符串（有效值：compaction="COMPACTION"）。优化器的类型。
操作
GetTableOptimizer 动作（Python：get_table_optimizer）
返回与指定表关联的所有优化器的配置。
请求
-
CatalogId–必填项：目录 id 字符串，长度不少于 1 个字节，并且不超过 255 个字节，并且符合 Single-line string pattern。表的目录 ID。
-
DatabaseName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表所在的目录中的数据库的名称。
-
TableName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表的名称。
-
Type— 必填：UTF-8 字符串（有效值：compaction="COMPACTION"）。优化器的类型。
响应
-
CatalogId– 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。表的目录 ID。
-
DatabaseName— UTF -8 个字符串，长度不小于 1 或超过 255 个字节，与. Single-line string pattern表所在的目录中的数据库的名称。
-
TableName— UTF -8 个字符串，长度不小于 1 或超过 255 个字节，与. Single-line string pattern表的名称。
-
TableOptimizer– 一个 TableOptimizer 对象。与指定表关联的优化器。
错误
EntityNotFoundExceptionInvalidInputExceptionAccessDeniedExceptionInternalServiceException
BatchGetTableOptimizer 操作（Python：batch_get_table_optimizer）
返回指定表优化器的配置。
请求
-
Entries– 必填：BatchGetTableOptimizerEntry 对象的数组。指定要检索的表优化器的
BatchGetTableOptimizerEntry对象列表。
响应
-
TableOptimizers– BatchTableOptimizer 对象的数组。BatchTableOptimizer对象的列表。 -
Failures– BatchGetTableOptimizerError 对象的数组。操作中所出现错误的列表。
错误
InternalServiceException
ListTableOptimizerRuns 操作（Python：list_table_optimizer_runs）
列出特定表的之前优化器运行历史记录。
请求
-
CatalogId–必填项：目录 id 字符串，长度不少于 1 个字节，并且不超过 255 个字节，并且符合 Single-line string pattern。表的目录 ID。
-
DatabaseName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表所在的目录中的数据库的名称。
-
TableName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表的名称。
-
Type— 必填：UTF-8 字符串（有效值：compaction="COMPACTION"）。优化器的类型。目前唯一有效的值是
compaction。 -
MaxResults– 数字（整数）。每次调用时将返回的最大优化器运行数。
-
NextToken— UTF -8 字符串。延续标记 (如果这是延续调用)。
响应
-
CatalogId– 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。表的目录 ID。
-
DatabaseName— UTF -8 个字符串，长度不小于 1 或超过 255 个字节，与. Single-line string pattern表所在的目录中的数据库的名称。
-
TableName— UTF -8 个字符串，长度不小于 1 或超过 255 个字节，与. Single-line string pattern表的名称。
-
NextToken— UTF -8 字符串。对返回的优化器运行列表进行分页的延续令牌（如果列表的当前段不是最后一段，则返回该令牌）。
-
TableOptimizerRuns– TableOptimizerRun 对象的数组。与表关联的优化器运行的列表。
错误
EntityNotFoundExceptionAccessDeniedExceptionInvalidInputExceptionInternalServiceException
CreateTableOptimizer 操作（Python：create_table_optimizer）
为特定函数创建新的表优化器。compaction 是目前唯一支持的优化器类型。
请求
-
CatalogId–必填项：目录 id 字符串，长度不少于 1 个字节，并且不超过 255 个字节，并且符合 Single-line string pattern。表的目录 ID。
-
DatabaseName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表所在的目录中的数据库的名称。
-
TableName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表的名称。
-
Type— 必填：UTF-8 字符串（有效值：compaction="COMPACTION"）。优化器的类型。目前唯一有效的值是
compaction。 -
TableOptimizerConfiguration– 必填：一个 TableOptimizerConfiguration 对象。表示表优化器的配置的
TableOptimizerConfiguration对象。
响应
无响应参数。
错误
EntityNotFoundExceptionInvalidInputExceptionAccessDeniedExceptionAlreadyExistsExceptionInternalServiceException
DeleteTableOptimizer 操作（Python：delete_table_optimizer）
删除一个表的一个优化器以及所有相关元数据。将不再对该表执行优化。
请求
-
CatalogId–必填项：目录 id 字符串，长度不少于 1 个字节，并且不超过 255 个字节，并且符合 Single-line string pattern。表的目录 ID。
-
DatabaseName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表所在的目录中的数据库的名称。
-
TableName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表的名称。
-
Type— 必填：UTF-8 字符串（有效值：compaction="COMPACTION"）。优化器的类型。
响应
无响应参数。
错误
EntityNotFoundExceptionInvalidInputExceptionAccessDeniedExceptionInternalServiceException
UpdateTableOptimizer 操作（Python：update_table_optimizer）
更新现有表优化器的配置。
请求
-
CatalogId–必填项：目录 id 字符串，长度不少于 1 个字节，并且不超过 255 个字节，并且符合 Single-line string pattern。表的目录 ID。
-
DatabaseName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表所在的目录中的数据库的名称。
-
TableName— 必填：UTF-8 个字符串，长度不小于 1 或超过 255 字节，匹配。Single-line string pattern表的名称。
-
Type— 必填：UTF-8 字符串（有效值：compaction="COMPACTION"）。优化器的类型。目前唯一有效的值是
compaction。 -
TableOptimizerConfiguration– 必填：一个 TableOptimizerConfiguration 对象。表示表优化器的配置的
TableOptimizerConfiguration对象。
响应
无响应参数。
错误
EntityNotFoundExceptionInvalidInputExceptionAccessDeniedExceptionInternalServiceException
