用途:该技能用于处理 Keboola 项目配置,帮助理解其 JSON 配置文件、编辑转换并分析项目结构,适用于管理数据管道时的配置操作。
项目结构:本地拉取的 Keboola 项目含 .keboola/manifest.json(项目元数据与分支信息)、.env.local(API token,不应提交)、.env.dist、.gitignore,以及按分支/组件/配置分层的目录;每个配置目录包含 config.json、meta.json,必要时有 rows/ 目录。
配置文件:manifest.json 包含项目 ID、API 主机、分支信息及排序命名约定;config.json 是每个组件的主配置,通常含 parameters、storage 和 processors;meta.json 描述配置名称、说明与是否禁用。
组件类型:转换(如 keboola.snowflake-transformation,SQL 或 Python/R)、提取器(如 keboola.ex-db-snowflake、keboola.ex-google-analytics-v4、keboola.ex-generic-v2)、写入器(如 keboola.wr-db-snowflake、keboola.wr-google-sheets)及编排器(keboola.orchestrator,含任务、依赖和调度)。
使用方式与常见任务:编辑前后运行 kbc diff,推送前校验 JSON,使用 kbc validate 检查有效性,保持 meta.json 描述更新;存储映射需对应输入输出表并统一命名;转换应拆分逻辑块、使用有意义的名称并加注释。添加输入表时在 storage.input.tables 中设置 source、destination、columns(空数组表示全部列);添加输出表需设 source、destination 与 primary_key;修改 SQL 脚本则编辑对应 block/code 的 script 数组。
限制与排错:配置无效时检查 JSON 语法、表名与列名映射;推送冲突需先拉取并手动合并再推送;表缺失需确认 Keboola Storage 中表存在、桶权限和大小写一致的表名。资料未提供更多关于收费、平台支持范围或具体版本的细节。