创建 Logicform 大数据导出任务

POST

/logicformExport:create

以当前用户身份创建异步导出任务。接口会立即返回 taskId，不会等待文件生成完成。

后续可通过 pollingUrl 查询任务状态，通过 downloadUrl 下载导出结果。

服务端按批执行 Logicform 并流式写入文件，避免一次性把完整结果集加载到内存中。 XLSX 会按 sheet 行数限制自动拆分 sheet，CSV 超过分片阈值会拆成多个文件；多文件时自动打包为 zip。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "format": "xlsx",
    "filename": "销售明细导出",
    "batchSize": 5000,
    "compress": "auto",
    "logicform": {
        "schema": "dwd_sales_detail_default",
        "limit": 100000,
        "preds": [
            {
                "pred": "销售金额",
                "operator": "$sum",
                "name": "销售金额"
            }
        ],
        "groupby": [
            {
                "name": "门店"
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/logicformExport:create' \
--header 'X-SPACES: default' \
--header 'X-SPACES: {{space}}' \
--header 'Referer: https://example.com' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "format": "xlsx",
    "filename": "销售明细导出",
    "batchSize": 5000,
    "compress": "auto",
    "logicform": {
        "schema": "dwd_sales_detail_default",
        "limit": 100000,
        "preds": [
            {
                "pred": "销售金额",
                "operator": "$sum",
                "name": "销售金额"
            }
        ],
        "groupby": [
            {
                "name": "门店"
            }
        ]
    }
}'

返回响应

🟢202

application/json

导出任务已创建

Bodyapplication/json

示例

{
    "taskId": "a1b2c3d4-1111-2222-3333-abcdefabcdef",
    "status": null,
    "pollingUrl": "/api/asyncTasks:get?filterByTk=a1b2c3d4-1111-2222-3333-abcdefabcdef",
    "downloadUrl": "/api/asyncTasks:fetchFile?filterByTk=a1b2c3d4-1111-2222-3333-abcdefabcdef"
}

🟠400

🟠401

修改于 2026-07-21 05:50:21

将 Logicform 转换为自然语言描述

根据执行日志 ID 获取 Logicform 调试信息