本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
表格优化器 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 字符串。优化器运行期间出现的错误。
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"
)。优化器的类型。
RunMetrics 结构
有关优化器运行的指标。
字段
-
NumberOfBytesCompacted
— UTF -8 字符串。由压缩作业运行移除的字节数。
-
NumberOfFilesCompacted
— UTF -8 字符串。由压缩作业运行移除的文件数。
-
NumberOfDpus
— UTF -8 字符串。任务消耗的DPU小时数。
-
JobDurationInHour
— UTF -8 字符串。作业的持续时间(以小时为单位)。
操作
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
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 对象的数组。与表关联的优化器运行的列表。
错误
EntityNotFoundException
AccessDeniedException
InvalidInputException
InternalServiceException
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
InvalidInputException
AccessDeniedException
AlreadyExistsException
InternalServiceException
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
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
InternalServiceException