更新时间:2025-04-21 GMT+08:00
分享

开启事务

操作场景

在使用数据库操作时,开启一个事务通常是为了确保一系列的操作要么全部成功执行,要么全部不执行,以此来保证数据的一致性。在工业数字模型驱动引擎-数据建模引擎(xDM Foundation,简称xDM-F)的事务型管理功能中,通过调用v3版本的开启事务接口,创建一个新的事务上下文,并返回一个唯一的事务ID。这个事务ID将用于后续的所有操作,确保它们都归属于同一个事务中。

前提条件

已在iDME控制台开启事务支持功能。

URI

  • URI格式:

    POST http://{Endpoint}/rdm_{appID}_app/services/rdm/basic/api/v3/transaction-apis/transactions

  • 参数说明:
    表1 URI参数说明

    参数

    是否必填

    参数类型

    描述

    Endpoint

    String

    承载REST服务端点的服务器域名或IP地址。

    appID

    String

    应用ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户的token。

响应参数

表3 响应Body参数

参数

参数类型

描述

result

String

调用是否成功。

  • SUCCESS:成功
  • FAIL:失败

data

List of data

调用的返回结果。

errors

List

异常信息列表。

表4 data

参数

参数类型

描述

transaction_id

String

事务ID。

请求示例

POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/v3/transaction-apis/transactions
X-Auth-Token: ABCDEFG....

响应示例

{
      "result": "SUCCESS",
      "data": [
          {
              "transaction_id": "538322343718555649"
          }
      ],
      "errors": []
}

相关文档