文档

CreateDataImportOrder - 创建数据导入工单

更新时间:

创建数据导入工单。

接口说明

仅管控模式为安全协同的数据库实例可调用此 API。

关于该功能的更多说明,请参见数据导入

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
dms:CreateDataImportOrderWrite
  • 全部资源
    *

请求参数

名称类型必填描述示例值
Commentstring

数据导入的业务背景,以减少沟通成本。

test
RelatedUserListarray

相关人列表。

long

变更相关人的用户 ID,设置的相关人员可查看工单,并协同工作,非相关人员则不能查看工单(管理员、DBA 除外)。

51****
Paramobject

工单参数。

Classifystring

数据导入原因。

test
AttachmentNamestring

导入数据的附件 Key(AttachmentKey),可通过调用接口 GetUserUploadFileJob 获取该参数的值。

order_text
DbItemListobject []

待导入的数据库列表,当前仅支持导入一个库。

DbIdlong

数据库 ID(DatabaseId),数据库分为物理库和逻辑库两种:

1860****
Logicboolean

是否为逻辑库,取值如下:

  • true:逻辑库
  • false:物理库
说明 如果取值为 true,目标数据库必须为逻辑库。
false
FileTypestring

文件类型,取值如下:

  • SQL:SQL 文件
  • CSV:CSV 文件
CSV
FileEncodingstring

文件编码,取值如下:

  • AUTO:自动识别
  • UTF-8:UTF8 编码
  • GBK:GBK 编码
  • ISO-8859-1:ISO-8859-1 编码
AUTO
TableNamestring

选择 CSV 格式文件导入数据的目标表。

说明 如果 FileTypeCSV,该参数必填。
Table_text
InsertTypestring

插入类型,取值如下:

  • INSERT:插入数据时数据库会检查主键(PrimaryKey),如果出现重复会报错。
  • INSERT_IGNORE:如果表中已经存在相同的记录,则忽略当前新数据。
  • REPLACE_INTO:如果表中已经有某行数据(根据主键或者唯一索引判断),则先删除此行数据,然后插入新的数据。
说明 如果 FileTypeCSV,该参数必填。
INSERT
CsvFirstRowIsColumnDefboolean

CSV 格式的类型,取值如下:

  • true:CSV 表格首行是字段名。
  • false:CSV 表格首行是数据。
说明 如果 FileTypeCSV,该参数必填。
true
IgnoreErrorboolean

是否忽略报错,取值如下:

  • true:忽略,遇到错误会跳过当前失败 SQL 脚本,继续执行。
  • false:不忽略,遇到出错则中断后面的 SQL 脚本,不再执行。
false
ImportModestring

导入模式,取值如下:

  • FAST_MODE:极速模式,在执行阶段读取文件,将 SQL 语句直接执行到指定的目标库。该模式安全性相比安全模式要低,但是执行时效较高。
  • SAFE_MODE:安全模式,在预检查阶段会解析文件并将 SQL 或 CSV 数据缓存入库,执行时再从缓存库中读出来执行到指定的目标库。该模式安全性较好,但是执行时效相比极速模式要低。
FAST_MODE
RollbackSQLstring

回滚 SQL 语句。

说明 如果 RollbackSqlTypeTEXT,该参数必填。
empty
RollbackAttachmentNamestring

回滚 SQL 附件 Key(AttachmentKey),可通过调用接口 GetUserUploadFileJob 获取该参数的值。

说明 如果 RollbackSqlTypeATTACHMENT,该参数必填。
rollback.sql
RollbackSqlTypestring

回滚 SQL 的提交方式,取值如下:

  • TEXT:文本
  • ATTACHMENT:附件
TEXT
AttachmentKeystring

工单附件 Key,补充当前工单信息。可通过调用接口 GetUserUploadFileJob 获取该参数的值。

order_attachment.txt
Tidlong

租户 ID,可通过调用接口 GetUserActiveTenantListUserTenants 获取该参数的值。

3***

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931
Successboolean

请求是否成功,返回值如下:

  • true:请求成功
  • false:请求失败
true
ErrorMessagestring

错误信息。

UnknownError
ErrorCodestring

错误码。

UnknownError
CreateOrderResultarray

工单创建结果。

long

工单号。

1****

示例

正常返回示例

JSON格式

{
  "RequestId": "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
  "Success": true,
  "ErrorMessage": "UnknownError",
  "ErrorCode": "UnknownError",
  "CreateOrderResult": [
    0
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读 (1)
文档反馈