表优化器 API - Amazon Glue
 —  数据类型  —TableOptimizerTableOptimizerConfigurationTableOptimizerRunRunMetricsBatchGetTableOptimizerEntryBatchTableOptimizerBatchGetTableOptimizerError —  操作  —GetTableOptimizer (get_table_optimizer)BatchGetTableOptimizer (batch_get_table_optimizer)ListTableOptimizerRuns (list_table_optimizer_runs)CreateTableOptimizer (create_table_optimizer)DeleteTableOptimizer (delete_table_optimizer)UpdateTableOptimizer (update_table_optimizer)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

表优化器 API

表优化器 API 介绍了用于启用压缩以提高读取性能的 Amazon 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 对象。

    与指定表关联的优化器。

错误

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

  • ThrottlingException

BatchGetTableOptimizer 操作（Python：batch_get_table_optimizer）

返回指定表优化器的配置。

请求

  • Entries – 必填：BatchGetTableOptimizerEntry 对象的数组。

    指定要检索的表优化器的 BatchGetTableOptimizerEntry 对象列表。

响应
错误

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

  • ThrottlingException

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 对象的数组。

    与表关联的优化器运行的列表。

错误

  • EntityNotFoundException

  • AccessDeniedException

  • InvalidInputException

  • ValidationException

  • InternalServiceException

  • ThrottlingException

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 对象。

响应

  • 无响应参数。

错误

  • EntityNotFoundException

  • ValidationException

  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • InternalServiceException

  • ThrottlingException

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"）。

    优化器的类型。

响应

  • 无响应参数。

错误

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

  • ThrottlingException

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 对象。

响应

  • 无响应参数。

错误

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • ValidationException

  • InternalServiceException

  • ThrottlingException