用途:在本地仓库中处理 Keboola 项目配置时提供专业知识,涵盖项目结构、配置格式与数据管道管理实践,也用于编辑转换、分析项目。
主要能力:解释拉取到本地的项目目录结构,包括 .keboola/manifest.json(项目元数据与分支信息)、.env.local(API 令牌,勿提交)、.env.dist 模板,以及按分支、组件、配置组织的目录(每项含 config.json、meta.json、rows/)。说明 config.json 的常见字段 parameters、storage、processors 与 meta.json 的 name、description、isDisabled。覆盖组件类型:转换(如 keboola.snowflake-transformation)、提取器(如 keboola.ex-db-snowflake、keboola.ex-google-analytics-v4、keboola.ex-generic-v2)、写入器(如 keboola.wr-db-snowflake、keboola.wr-google-sheets)、编排(keboola.orchestrator)。提供常见任务做法:在 storage.input.tables 添加输入表、在 storage.output.tables 添加输出表、修改转换脚本数组。
使用方式:编辑后用 kbc diff 前后对比;推送前校验 JSON 语法;用 kbc validate 检查配置有效性;在 .env.local 配置 API 令牌;保持 meta.json 描述更新。存储映射中区分输入表的工作名与输出表的目标 bucket,命名保持一致。转换逻辑拆分为多个 block,为 block 和脚本取有意义的名称,SQL 加注释,条件允许时本地测试。
适用场景:需要读懂或修改本地 Keboola 配置、排查配置错误、解决推送冲突、检查缺失表的场景。
限制:具体组件的完整参数集、价格、平台细节资料未提供;排错建议包括检查 JSON 语法、确认表与列名存在、先拉取最新变更再手动合并冲突。