本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
对象 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
用于验证并用于标识基础数据的更改。 -
大小的大小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
用于验证并用于标识基础数据的更改。 -
大小的大小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
一起指定。 -
截至读取受管理的表内容的时间。如果未设置,将使用最近的事务提交时间。无法与
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