云数据库 TiDB 版
云数据库 TiDB 版
文档指南
请输入
- 文档首页
云数据库 TiDB 版API 参考导入任务管理GetImportTaskDetails - 获取导入任务详情
复制全文
下载 pdfGetImportTaskDetails - 获取导入任务详情
文档反馈
问问助手调用 GetImportTaskDetails 接口获取导入任务详情。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：GetImportTaskDetails
要执行的操作，取值：GetImportTaskDetails。
Version string 必选 示例值：2026-06-30
API的版本，取值：2026-06-30。
ImportId string 必选 示例值：imp-2pmo22erdjdtbh54mnjg******
导入任务 ID。
说明
ProjectName string 可选 示例值：default
项目名称。
InstanceId string 必选 示例值：tidb-544c96a2******
实例 ID。
返回参数
Import_ object 示例值：{ "AllCompletedTables": [ { "DataFilePattern": "*tpcc_db.customer10*.csv*", "Result": "SUCCESS", "TableName": "tpcc_db.customer10" }, { "DataFilePattern": "*tpcc_db.customer1*.csv*", "Result": "SUCCESS", "TableName": "tpcc_db.customer1" } ], "InstanceId": "tidb-544c96a2******", "CompatibleId": "1237244", "CompletePercent": 100, "CompleteTime": "2026-06-30T09:01:52Z", "CreateTime": "2026-06-30T08:56:33Z", "CreationDetails": { "ImportOptions": { "CsvFormat": { "BackslashEscape": true, "Delimiter": "\"", "Header": true, "NotNull": false, "NullValue": "\\N", "Separator": ",", "TrimLastSeparator": false }, "FileType": "CSV", "NeedDropTable": false }, "Source": { "Tos": { "AccessKey": { "Id": "AKLT*********" }, "AuthType": "ACCESS_KEY", "Uri": "tos://test-tidb/CVS/" }, "Type": "TOS" } }, "ImportId": "imp-rqnomxhdqzeo5gkiij******", "Name": "import_2026-06-30T08:56:33Z", "PostImportCompletedPercent": 100, "StartTime": "2026-06-30T08:59:09Z", "State": "COMPLETED", "TotalSize": "35854387", "TotalTablesCount": 2 }
导入任务详情。
ImportId string
导入任务 ID。
TotalSize string
待导入数据总大小（uint64 字符串）。
CreateTime string
创建时间。
CompleteTime string
完成时间。
State string
导入状态。
CompletePercent integer
完成百分比。
Message string
失败时的错误信息。
CreationDetails object
创建时配置详情。
ImportOptions object
导入选项配置。
NeedDropTable boolean
是否先删除目标表（仅 tutorial 场景使用）。
FileType string
数据格式。取值如下：
- CSV：CSV 格式。
- Parquet：Parquet 格式。
- AURORA_SNAPSHOT：AURORA_SNAPSHOT 格式。
- SQL：SQL 格式。
CsvFormat object
CSV 格式配置。
Header boolean 示例值：true
是否包含首行表头。取值如下:
- true：包含。
- false：不包含。
NotNull boolean 示例值：true
是否禁止列为 NULL。取值如下：
- true：禁止。
- false：不禁止。
NullValue string 示例值：\\N
NULL 的字符串表示。
BackslashEscape boolean 示例值：true
是否转义反斜杠。取值如下:
- true：转义。
- false：不转义。
TrimLastSeparator boolean 示例值：true
是否去除行尾多余分隔符。取值如下:
- true：去除。
- false：不去除。
Separator string 示例值：,
列分隔符。
Delimiter string 示例值：\"
包裹符。
Source object
数据源配置。
Type string 示例值：TOS
数据源类型。
Tos object
TOS 源配置。
Uri string
TOS URI。
AuthType string
固定为 ACCESS_KEY。
AccessKey object
访问凭证。
Id string
AccessKey ID。
Secret string
AccessKey Secret。
TargetTableInfos object[]
导入目标表信息。
TargetTable object
目标表信息。
Database string
数据库名。
Table string
表名。
CustomFile string
自定义文件，为空时使用默认规则导入数据。
Local object
本地文件导入源配置。
UploadId string
上传文件的 upload_id。
TargetDatabase string
目标数据库。
TargetTable string
目标表。
FileName string
导入文件名（只读）。
Columns object[]
目标表列定义
说明
目标表不存在时用于建表。
ColumnName string
列名。
ColumnType string
列类型。
PkColumns string[]
主键列（仅输入）。
AllCompletedTables object[]
已完成的表信息。
TableName string
表名。
Result string
导入结果。
Message string
导入信息。
DataFilePattern string
数据文件匹配规则。
PostImportCompletedPercent integer
数据导入后的整体校验进度。
CompatibleId string
兼容 dataflow-svc v1beta OPENAPI 的 uint64 标识（字符串）。
StartTime string
导入开始时间。
TotalTablesCount integer
导入表总数。
InstanceId string
目标实例 ID。
请求示例
返回示例
错误码
最近更新时间：2026.10.30 11:06:01
这个页面对您有帮助吗？
有用
有用
无用
无用