事务 API - Amazon Lake Formation
 —  数据类型  —交易说明虚拟对象 —  操作  —Starttransaction（start_transaction）事务提交（commit _transaction）Canceltransaction（ancel_transaction）扩展交易（extend_交易）描述交易（describe_交易）列出交易（list_交易）在取消时删除对象 (delete _objects_on_ancel) — 异常情况 —交易委员会正在进行中例外交易中止了异常交易委员会例外TransactionCanceledException交易争议例外ResourceNotReadyException
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 字符串。

    描述错误的消息。