文章目录一、Stream Load通过 HTTP 导入数据二、导入状态查询三、取消导入任务四、节点状态监控查看所有 Backend 状态查看所有 Frontend 状态五、导入失败的排查方式1. 查询导入任务状态2. 下载详细错误日志3. 查看 FE/BE 节点日志FE 日志路径BE 日志路径grep 示例六、常见错误类型与建议处理方式StarRocks 是一款面向分析型场景的高性能 MPP 数据库提供了丰富的 HTTP 接口广泛用于数据导入、系统状态查询和任务管理。本文将系统梳理 StarRocks 常用的 HTTP 操作命令并介绍如何排查数据导入过程中的常见错误。一、Stream Load通过 HTTP 导入数据Stream Load 是 StarRocks 最常用的数据导入方式之一适合小批量、实时的数据写入。示例命令CSV 文件导入curl-uuser:password\-Hlabel: test_load_001\-Hcolumn_separator:,\-T./data.csv\http://fe_host:8030/api/db_name/table_name/_stream_load参数说明user:passwordStarRocks 用户名与密码label导入任务的唯一标识符建议每次都设置column_separator列分隔符默认是 TAB-T要上传的文件路径URL 格式http://FE_HOST:8030/api/{db}/{table}/_stream_load支持的其他参数format: json支持 JSON 格式导入strip_outer_array: trueJSON 数组展开导入Content-Encoding: gzip支持压缩导入如.gz文件二、导入状态查询导入任务完成后可以使用 label 查询其状态curl-uuser:password\http://fe_host:8030/api/db_name/_load?labeltest_load_001返回内容将包含任务状态成功、失败、错误摘要及错误日志链接。三、取消导入任务如果某个导入任务未完成或卡住可以通过以下命令取消curl-XDELETE-uuser:password\http://fe_host:8030/api/db_name/_load?labeltest_load_001四、节点状态监控查看所有 Backend 状态curlhttp://fe_host:8040/api/show_backends查看所有 Frontend 状态curlhttp://fe_host:8030/api/show_frontends五、导入失败的排查方式如果导入失败可以通过以下步骤排查问题。1. 查询导入任务状态curl-uuser:password\http://fe_host:8030/api/db_name/_load?labeltest_label关注返回结果中的status: 是否为failmsg: 错误摘要errorURL: 下载详细错误日志链接2. 下载详细错误日志curl-Ohttp://be_host:8040/api/_load_error_log?filebe_err_log_xxx.log日志内容可能包括字段类型不匹配、NULL 错误等。3. 查看 FE/BE 节点日志FE 日志路径${STARROCKS_HOME}/fe/log/load.log导入相关日志fe.log通用日志可搜stream loadBE 日志路径${STARROCKS_HOME}/be/log/be.log详细错误处理信息grep 示例greptest_label${STARROCKS_HOME}/fe/log/load.log六、常见错误类型与建议处理方式错误类型原因处理建议Data type mismatch数据格式与表字段不匹配检查字段类型、NULL 值、分隔符unexpected null非空字段出现 NULL检查字段是否缺失或多余分隔符Label already exists重复使用 label更换 label或使用 UUID 动态生成File too large单个文件过大拆分文件、提升导入参数限制Timeout网络或导入超时检查网络和 FE/BE 负载
