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

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

对象 API

Object API 在中描述了受管理的表对象Amazon Lake Formation.

数据类型

Table 对象结构

指定受管理表的详细信息。

字段

  • Uri - 统一资源标识符 (uri),不少于 1 个字节或超过 1024 个字节,与 URI address multi-line string pattern 匹配。

    这些区域有:Amazon S3对象的位置。

  • ETag – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Custom string pattern #11 匹配。

    这些区域有:Amazon S3Tag 对象的 ETag。返回方GetTableObjects用于验证并用于标识基础数据的更改。

  • Size – 数字(长型)。

    大小的大小Amazon S3对象以字节为单位。

Transform 对象结构

包含分区值和表对象列表的结构。

字段

  • PartitionValues— UTF-8 字符串数组,不少于 1 个或不超过 100 个字符串。

    分区值的列表。

  • Objects表对象 对象的数组。

    表对象的列表

addoBjectInput 结构

要添加到受管理表的新对象。

字段

  • Uri:必需 统一资源标识符 (uri),长度不少于 1 个字节或超过 1024 个字节,与匹配。URI address multi-line string pattern.

    这些区域有:Amazon S3对象的位置。

  • ETag:必需 UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与匹配。Custom string pattern #11.

    这些区域有:Amazon S3Tag 对象的 ETag。返回方GetTableObjects用于验证并用于标识基础数据的更改。

  • Size:必需 数字 (long)。

    大小的大小Amazon S3对象以字节为单位。

  • PartitionValues— UTF-8 字符串数组,不少于 1 个或不超过 100 个字符串。

    对象的分区值的列表。必须为与表关联的每个分区键指定一个值。

    支持的数据类型包括整数、长型、日期 (yyyy-MM-dd)、时间戳 (yyy-mm-dd hh: mm: SSXXX 或 yyy-mm-dd hh: mm: SS”)、字符串和小数点数。

DeceObjectInput 结构

要从受管理的表中删除的对象。

字段

  • Uri:必需 统一资源标识符 (uri),长度不少于 1 个字节或超过 1024 个字节,与匹配。URI address multi-line string pattern.

    这些区域有:Amazon S3要删除的对象的位置。

  • ETag – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Custom string pattern #11 匹配。

    这些区域有:Amazon S3Tag 对象的 ETag。返回方GetTableObjects用于验证并用于标识基础数据的更改。

  • PartitionValues— UTF-8 字符串数组,不少于 1 个或不超过 100 个字符串。

    对象的分区值的列表。必须为与受管理表关联的每个分区键指定一个值。

WriteOpform 结构

定义要在受管理表中添加或删除的对象。

字段

  • AddObject – 一个 addobject输入 对象。

    要添加到受管理表的新对象。

  • DeleteObject – 一个 删除对象输入 对象。

    要从受管理的表中删除的对象。

操作

GetTable对象操作(Python:get_table_object)

返回一组Amazon S3对象组成指定的受管理表。可以为时间旅行查询指定交易 ID 或时间戳。

请求

  • CatalogId – 目录 id 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    包含受管理表的目录。默认为来电者的帐户。

  • DatabaseName:必需 UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与匹配。Single-line string pattern.

    包含受管理表的数据库。

  • TableName:必需 UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与匹配。Single-line string pattern.

    要检索对象的受管理表。

  • TransactionId – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Custom string pattern #11 匹配。

    在该 ID 处读取受管理的表内容的事务 ID。如果此事务已中止,将返回错误。如果未设置,则默认为最近提交的事务。无法与 QueryAsOfTime 一起指定。

  • QueryAsOfTime – 时间戳。

    截至读取受管理的表内容的时间。如果未设置,将使用最近的事务提交时间。无法与 TransactionId 一起指定。

  • PartitionPredicate – 谓词字符串,不超过 2048 个字节,与 URI address multi-line string pattern 匹配。

    根据受管理表中定义的分区键筛选返回的对象的谓词。

    • 支持的比较运算符有:=、>、<、>=、<=

    • 支持的逻辑运算符有:AND

    • 支持的数据类型包括整数、长型、日期 (yyyy-MM-dd)、时间戳 (yyy-mm-dd hh: mm: SSXXX 或 yyy-mm-dd hh: mm: SS”)、字符串和小数点数。

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

    指定在页面中返回多少值。

  • NextToken— UTF-8 字符串,长度不超过 4096 个字节。

    延续标记(如果这不是检索这些对象的第一次调用)。

响应

  • Objects分区对象 对象的数组。

    按分区键组织的对象的列表。

  • NextToken— UTF-8 字符串,长度不超过 4096 个字节。

    一个延续令牌,指示是否有其他数据可用。

错误

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

  • OperationTimeoutException

  • TransactionCommittedException

  • TransactionCanceledException

  • ResourceNotReadyException

UpdateTable 对象操作(Python:update_table_object)

更新清单Amazon S3对象组成指定的受管理表。

请求

  • 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.

    要更新的受管理表。

  • TransactionId:必需 UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与匹配。Custom string pattern #11.

    要执行写入的交易。

  • WriteOperations:必需 数组写操作对象,不少于 1 个或不超过 100 个结构。

    列表WriteOperation定义要添加到受管理表的清单中或从清单中删除的对象的对象。

响应

  • 无响应参数。

错误

  • InternalServiceException

  • InvalidInputException

  • OperationTimeoutException

  • EntityNotFoundException

  • TransactionCommittedException

  • TransactionCanceledException

  • TransactionCommitInProgressException

  • ResourceNotReadyException

  • ConcurrentModificationException