请求方式	GET
请求地址	`https://api.coze.cn/v1/database_tasks/:task_id`
权限	仅发起异步任务的请求者可以查询异步执行结果。
接口说明	查询扣子数据库异步执行结果。

请求参数

参数	取值	说明
Authorization	Bearer $Access_Token	用于验证客户端身份的访问令牌。你可以在扣子平台中生成访问令牌，详细信息，参考准备工作。
Content-Type	application/json	请求正文的方式。

Path

参数	类型	是否必选	示例	说明
task_id	String	必选	761070127115408****	提交异任务返回时的任务 ID。任务 ID可从插入数据、更新数据、查询数据或者删除数据接口获取。

返回参数

参数	类型	示例	说明
data	Object of AsyncTaskResultData	{“status”:“succeed”,“task_type”:“insert”,“affected_rows”:2}	返回异步查询结果信息。
code	Long	0	调用状态码。 0 表示调用成功。其他值表示调用失败。你可以通过 msg 字段判断详细的错误原因。
msg	String	“”	状态信息。API 调用失败时可通过此字段查看详细错误信息。状态码为 0 时，msg 默认为空。
detail	Object of ResponseDetail	{“logid”:“20241210152726467C48D89D6DB2****”}	包含请求的详细信息的对象，主要用于记录请求的日志 ID 以便于排查问题。

AsyncTaskResultData

参数	类型	示例	说明
status	String	succeed	异步任务的状态，枚举值如下： `pending`：等待中 `running`：执行中 `succeed`：成功 `failed`：失败
has_more	Boolean	false	标识当前返回的数据是否为完整数据集。取值如下： `true` ：表示未返回所有数据。 `false`：表示已返回所有数据。
error_msg	String	“”	错误信息。
task_type	String	select	异步任务的操作类型，枚举值如下： `select`：查询 `insert`：插入 `update`：更新 `delete`：删除
affected_rows	Integer	12	异步任务操作影响的数据行数，仅当任务的操作类型为 `insert`、`update` 或 `delete`且任务状态为 `succeed`时返回该字段。
select_total_count	Integer	156	符合查询条件的数据条目总数，仅当任务的操作类型为 `select` 时返回该字段。
select_items_file_url	String	`https://example.com/results/761070127115408****`	`select` 操作的查询结果列表文件 URL。该 URL 指向一个包含查询结果的 JSON 文件，仅当任务的操作类型为 `select` 且任务状态为 `succeed` 时返回该字段。

ResponseDetail

参数	类型	示例	说明
logid	String	20241210152726467C48D89D6DB2****	本次请求的日志 ID。如果遇到异常报错场景，且反复重试仍然报错，可以根据此`logid`及错误码联系扣子团队获取帮助。详细说明可参考获取帮助和技术支持。

示例

请求示例

curl --location --request GET 'https://api.coze.cn/v1/database_tasks/7525340985****' \
--header 'Authorization: Bearer pat_O****' \
--header 'Content-Type: application/json'

返回示例

{
    "detail": {
        "logid": "20241210152726467C48D89D6DB2****"
    },
    "code": 0,
    "data": {
        "status": "succeed",
        "task_type": "insert",
        "affected_rows": 2
    },
    "msg": ""
}

错误码

如果成功调用扣子编程的 API，返回信息中 code 字段为 0。如果状态码为其他值，则表示接口调用失败。此时 msg 字段中包含详细错误信息，你可以参考错误码文档查看对应的解决方法。