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

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

事务 API

事务 API 描述了以事务方式更新中表格内容的操作Amazon Lake Formation.

数据类型

事务描述结构

一个包含事务相关信息的结构。

字段

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

    事务的 ID。

  • TransactionStatus – UTF-8 字符串(有效值:ACTIVE | COMMITTED | ABORTED | COMMIT_IN_PROGRESS)。

    状态为 “活动”、“已提交” 或 “已中止”。

  • TransactionStartTime – 时间戳。

    事务开始的时间。

  • TransactionEndTime – 时间戳。

    提交或中止事务的时间(如果当前处于活动状态)。

Virtual Object 结构

一个定义Amazon S3如果交易取消,则要删除的对象,前提是VirtualPut是在写对象之前调用的。

字段

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

    的路径Amazon S3对象。必须以 s3://开头

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

    的 eTagAmazon S3对象。

操作

StartTranstransaction 操作(Python:start_transaction)

启动新交易并返回其交易 ID。事务 ID 是不透明的对象,您可以用它来识别交易。

请求

  • TransactionType – UTF-8 字符串(有效值:READ_AND_WRITE | READ_ONLY)。

    指示此事务应为只读还是读写。使用只读事务 ID 进行的写入将被拒绝。只读事务不需要提交。

响应

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

    事务的不透明标识符。

错误

  • InternalServiceException

  • OperationTimeoutException

事务操作(Python:commit _transaction)

尝试提交指定的事务。如果事务以前已中止,则返回异常。如果对同一事务多次调用此 API 操作,则是幂等的。

请求

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

    要提交的交易。

响应

  • TransactionStatus – UTF-8 字符串(有效值:ACTIVE | COMMITTED | ABORTED | COMMIT_IN_PROGRESS)。

    事务的状态。

错误

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • TransactionCanceledException

  • ConcurrentModificationException

Canceltransaction 操作(Python:ancel_transaction)

尝试取消指定的事务。如果事务以前已提交,则返回异常。

请求

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

    要取消的事务。

响应

  • 无响应参数。

错误

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • TransactionCommittedException

  • TransactionCommitInProgressException

  • ConcurrentModificationException

ExendDtransaction 操作(Python:extend_transaction)

向服务表明指定的事务仍处于活动状态,不应将其视为空闲和中止。

除非明确延长,否则长时间处于空闲状态的写入事务将自动中止。

请求

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

    要延长的交易。

响应

  • 无响应参数。

错误

  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • TransactionCommittedException

  • TransactionCanceledException

  • TransactionCommitInProgressException

事务操作(Python:descripbe_transaction)

返回单个事务的详细信息。

请求

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

    要返回状态的交易。

响应

  • TransactionDescription – 一个 交易说明 对象。

    返回TransactionDescription包含事务相关信息的对象。

错误

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

Listtransaction 操作(Python:list_transaction)

返回有关交易及其状态的元数据。为了防止响应无限期增长,只返回未提交的事务和可用于时间旅行查询的事务。

此操作可以帮助您识别未提交的事务或获取有关交易的信息。

请求

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

    要列出交易记录的目录。默认值为调用者的账户 ID。

  • StatusFilter – UTF-8 字符串(有效值:ALL | COMPLETED | ACTIVE | COMMITTED | ABORTED)。

    指示要返回的交易状态的过滤器。选项全部 | 已完成 | 已提交 | 已中止 | 活动。默认为 ALL

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

    要在单个调用中返回的最大交易数。

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

    延续令牌(如果这不是检索事务的第一个调用)。

响应

  • Transactions交易说明 对象的数组。

    交易清单。每笔交易的记录都是TransactionDescription对象。

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

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

错误

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

DeleteObjects 操作(Python:delete_objects_on_ance_transaction)

对于特定的受管理表,请提供Amazon S3将在当前事务期间写入的对象,如果事务被取消,则可以自动删除该对象。没有这个电话,不Amazon S3当事务取消时,对象将自动删除。

这些区域有:Amazon GlueETL 库函数write_dynamic_frame.from_catalog()包括自动呼叫的选项DeleteObjectsOnCancel在写之前。有关更多信息,请参阅 。回滚Amazon S3写入.

请求

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

    这些区域有:Amazon Glue包含受管理表的数据目录。默认为当前账户 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.

    写入进行的事务的 ID。

  • Objects必填项:数组虚拟对象对象,不少于 1 个或不超过 100 个结构。

    VirtualObject 结构的列表,指示Amazon S3如果事务取消,则要删除的对象。

响应

  • 无响应参数。

错误

  • InternalServiceException

  • InvalidInputException

  • OperationTimeoutException

  • EntityNotFoundException

  • TransactionCommittedException

  • TransactionCanceledException

  • ResourceNotReadyException

  • ConcurrentModificationException

异常

Progrestransaction 异常结构

包含与正在进行的事务提交相关的错误的详细信息。

字段

  • Message – UTF-8 字符串。

    描述错误的消息。

事务中止异常结构

包含有关指定交易已中止且无法用于的错误的详细信息UpdateTableObjects.

字段

  • Message – UTF-8 字符串。

    描述错误的消息。

事务委员会异常结构

包含有关指定事务已经提交且无法用于的错误的详细信息UpdateTableObjects.

字段

  • Message – UTF-8 字符串。

    描述错误的消息。

TransactionCanceledException 结构

包含与已取消的交易相关的错误的详细信息。

字段

  • Message – UTF-8 字符串。

    描述错误的消息。

事务争议异常结构

包含有关可重试错误的详细信息,该错误表明由于争用或冲突而导致提交未成功。

字段

  • Message – UTF-8 字符串。

    描述错误的消息。

ResourceNotReadyException 结构

包含与尚未准备好进行交易的资源相关的错误的详细信息。

字段

  • Message – UTF-8 字符串。

    描述错误的消息。