存储 API - Amazon Lake Formation
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

存储 API

存储 API 允许您管理中受管理表的存储优化Amazon Lake Formation.

数据类型

StorageOptimizer 结构

描述存储优化程序的配置和详细信息的结构。

字段

  • StorageOptimizerType – UTF-8 字符串(有效值:compaction="COMPACTION" | garbage_collection="GARBAGE_COLLECTION" | index="INDEX" | copy_on_write="COPY_ON_WRITE" | all="GENERIC")。

    特定类型的存储优化器。支持的值为 compaction

  • Config – 键值对的映射数组。

    每个键是一个 UTF-8 字符串。

    每个值是一个 UTF-8 字符串。

    存储优化程序配置的映射。目前只包含一个键值对:is_enabled表示加速度为真或假。

  • ErrorMessage – UTF-8 字符串。

    包含有关任何错误(如果存在)的信息的消息。

    当加速结果为已启用状态时,错误消息为空。

    当加速结果处于禁用状态时,该消息将描述错误或仅表示 “被用户禁用”。

  • Warnings – UTF-8 字符串。

    包含有关任何警告(如果存在)的信息的消息。

  • LastRunDetails – UTF-8 字符串。

    当加速结果为已启用状态时,将包含上次作业运行的详细信息。

操作

ListTable StorageOptimizer 操作(Python:list_table_storage_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.

    表名称.

  • StorageOptimizerType – UTF-8 字符串(有效值:compaction="COMPACTION" | garbage_collection="GARBAGE_COLLECTION" | index="INDEX" | copy_on_write="COPY_ON_WRITE" | all="GENERIC")。

    要列出的特定类型的存储优化器。支持的值为 compaction

  • MaxResults – 数字(整数),不小于 1 或大于 1000。

    每次调用时要返回的存储优化器的数量。

  • NextToken – UTF-8 字符串。

    延续标记 (如果这是延续调用)。

响应

  • StorageOptimizerList存储优化器 对象的数组。

    与表关联的存储优化程序的列表。

  • NextToken – UTF-8 字符串。

    对返回的标记列表进行分页的延续令牌 (如果列表的当前片段不是最后一个,则返回)。

错误

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateTableStorageOptimizer 操作(Python:update_table_storage_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.

    要启用存储优化程序的表的名称。

  • StorageOptimizerConfig:必需 键值对的映射数组。

    每个键是一个 UTF-8 字符串(有效值:compaction="COMPACTION"|garbage_collection="GARBAGE_COLLECTION"|index="INDEX"|copy_on_write="COPY_ON_WRITE"|all="GENERIC")。

    每个值都是键值对的映射数组。

    每个键是一个 UTF-8 字符串。

    每个值是一个 UTF-8 字符串。

    要启用存储优化程序的表的名称。

响应

  • Result – UTF-8 字符串。

    操作失败的响应。

错误

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException