Back to Details

databricks-dabs

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Declarative Automation Bundles (DABs)

声明式自动化包（DABs）

Use this skill for any bundle-related request including creating, configuring, validating, deploying, running, and managing Databricks resources through DABs.
你可以将本技能用于所有与包相关的需求，包括通过DABs创建、配置、验证、部署、运行和管理Databricks资源。

Reference Documentation

参考文档

The following reference files provide detailed guidance for specific bundle tasks:
  • Bundle Structure - Bundle structure, databricks.yml configuration, resource definitions, path resolution, variables, and multi-environment targets
  • SDP Pipelines - Spark Declarative Pipeline configurations for DABs
  • SQL Alerts - SQL Alert schemas and configuration (critical - API differs from other resources)
  • Deploy and Run - Validation, deployment, running resources, monitoring logs, and troubleshooting common issues
  • Resource Permissions - Permission levels and access control for bundle resources, per-resource-type levels, grants vs permissions
以下参考文件为特定的包任务提供详细指导：
  • 包结构 - 包结构、databricks.yml配置、资源定义、路径解析、变量和多环境目标
  • SDP Pipelines - 适用于DABs的Spark声明式流水线配置
  • SQL告警 - SQL Alert schema和配置（重要提示：其API与其他资源不同）
  • 部署与运行 - 验证、部署、运行资源、监控日志及常见问题排查
  • 资源权限 - 包资源的权限级别和访问控制、各资源类型权限级别、授权与权限的区别

When to Use This Skill

何时使用本技能

Load this skill for any request involving:
  • Creating new bundle projects or resources
  • Configuring databricks.yml or resource YAML files
  • Setting up multi-environment deployments (dev/prod targets)
  • Deploying or running bundle resources
  • Managing permissions for bundle resources
  • Troubleshooting bundle validation or deployment errors
  • Working with specific resource types (dashboards, jobs, pipelines, alerts, volumes, apps)
当你的需求涉及以下场景时可加载本技能：
  • 创建新的包项目或资源
  • 配置databricks.yml或资源YAML文件
  • 设置多环境部署（dev/prod目标）
  • 部署或运行包资源
  • 管理包资源的权限
  • 排查包验证或部署错误
  • 使用特定类型的资源（仪表盘、作业、流水线、告警、存储卷、应用）

General Guidelines

通用指南

  1. Always validate after configuration changes - Use 
    bundle validate --strict --target <target>
    after any change
  2. Use reference documentation - Consult the appropriate reference file for detailed patterns and examples
  3. Follow naming conventions - Resource files should use 
    <name>.<resource_type>.yml
    format
  4. Path resolution is critical - Paths differ based on file location (see Bundle Structure reference)
  5. Preserve existing structure - Keep user comments and structure when editing YAML files
  6. Use variables - Parameterize catalog, schema, and warehouse for multi-environment support
  1. 配置变更后始终执行验证 - 任何变更后都要使用
    bundle validate --strict --target <target>
  2. 参考对应文档 - 查阅合适的参考文件获取详细模式和示例
  3. 遵循命名规范 - 资源文件应采用
    <name>.<resource_type>.yml
    格式
  4. 路径解析至关重要 - 路径会因文件位置不同而有差异（参见包结构参考文档）
  5. 保留现有结构 - 编辑YAML文件时请保留用户注释和原有结构
  6. 使用变量 - 对catalog、schema和warehouse进行参数化配置以支持多环境部署