观澜接入快速上手

v1.4 · 2023-10-19 · 适用 guanlan-gateway 1.4.x · 观澜组
本页为 v1 归档。2026 年起新接入请直接看 v2 API 参考;v1 示例中的查询串 token 已停用。

第一步:申请令牌

在控制台“接入信息”页提交申请表,写明系统名、负责人、预计数据量。审批通常在 1 个工作日内完成,令牌形如 glk_live_ 加 24 位小写字符。

第二步:创建第一个采集任务

POST /api/v1/collect/create?token=<YOUR_TOKEN>

{
  "dataset_id": 10044,
  "src": "beichen-share",
  "dst": "xiran-prod",
  "fmt": "parquet",
  "max_records": 5000000
}

成功时返回 code=0,并带回 job_id。若返回 1006,先检查 dataset_id 是否为数字(v1 不接受字符串)。

第三步:查询任务状态

GET /api/v1/collect/status?job=88213&token=<YOUR_TOKEN>

{"code":0,"message":"ok","data":{
   "job_id":88213,"state":"RUNNING",
   "processed":4120000,"total":5000000}}

建议轮询间隔 30 秒以上;1.4 版本在任务密集时偶发状态滞后 1–2 分钟,属已知现象。

第四步:取数

任务 DONE 后数据写入息壤桶 xiran-prod 的目标路径,路径规则:guanlan/{dataset_name}/{yyyyq}/part-*.parquet。可直接在 息壤 挂载点 /xiran/data 下读取。

常见问题

更多问题见 v1 归档目录 与 常见问题汇总。

Copyright © 2023 归藏研究所 · 页面最后编辑 2023-10-19 · 归档只读