验证技能Skill validate

验证技能用于验证Starlake项目配置的YAML文件语法、模式合规性、连接引用等,确保在运行时前捕获配置错误,提升数据治理和ETL流程的可靠性。关键词:验证、配置管理、YAML语法、Starlake工具、数据治理、ETL开发、错误预防。

数据治理 0 次安装 0 次浏览 更新于 3/15/2026

name: validate description: Validate project configuration, YAML files, and connections

验证技能

验证您的Starlake项目配置,包括YAML文件语法、模式合规性、连接配置和DAG引用。这在运行时之前捕获配置错误。

用法

starlake validate [options]

选项

  • --reload:在验证前重新加载所有YAML文件从磁盘
  • --reportFormat <value>:报告输出格式:consolejsonhtml

验证内容

  • YAML语法:所有*.sl.yml文件被解析和验证
  • 模式合规性:文件根据Starlake JSON Schema进行验证
  • 类型引用:属性类型必须匹配types/default.sl.yml中的定义
  • 连接引用:所有connectionRef值必须指向已定义的连接
  • DAG引用:所有dagRef值必须指向现有的DAG配置
  • 外键引用foreignKey属性必须引用现有的表
  • 写入策略一致性:键/时间戳列必须在属性中存在

IDE验证

对于VS Code中的实时验证,添加到.vscode/settings.json

{
  "yaml.schemas": {
    "https://json.schemastore.org/starlake.json": [
      "metadata/**/*.sl.yml"
    ]
  }
}

示例

验证整个项目

starlake validate

带重载验证

强制在验证前从磁盘重新加载所有文件:

starlake validate --reload

带JSON报告验证

starlake validate --reportFormat json

相关技能