Saltar al contenido
Lakehouse LabLakehouse LabPreparación Databricks Data Engineer
Módulo 29 · Lección

Variables, substitutions y targets

Contenido abierto

Puedes leer todo sin registrarte. Solo crearemos un perfil anónimo cuando decidas guardar tu progreso.

Lección 3 de 5

Variables, substitutions y targets

Usa `validate`, `plan`, `deploy` y `run` como puertas distintas; no conviertas un deploy correcto en prueba suficiente del workload.

Duración
17 min aprox.
Objetivo
Usa `validate`, `plan`, `deploy` y `run` como puertas distintas; no conviertas un deploy correcto en prueba suficiente del workload.
Siguiente paso
Continuar con la siguiente lección
Ver detalles del módulo

Declarative Automation Bundles y CI/CD

Define recursos como código y promociona el mismo artefacto validado entre targets.

Al terminar podrás
  • Estructurar un bundle completo
  • Validar y desplegar con CLI
  • Integrar identidad de servicio y pipeline Git
Ver fuentes y revisión

Metadatos editoriales

Última revisión
21 jul 2026
Nivel
Professional
Ruta relacionada
delivery
Dominios blueprint
Deploying CI/CD · Databricks CLI
Estado
Revisión editorial interna
Fuentes principales
What are Declarative Automation Bundles? · Bundle command group
Reportar un error
03
Operación

Variables, substitutions y targets

Usa `validate`, `plan`, `deploy` y `run` como puertas distintas; no conviertas un deploy correcto en prueba suficiente del workload.

Mostrar prerrequisitos
Dificultad
Professional
Prerrequisitos
m28
Reportar un error en esta lección

`bundle validate` resuelve configuración y comprueba el esquema contra el target. `bundle plan` muestra acciones previstas sin aplicarlas. `bundle deploy` sincroniza artefactos y recursos, y `bundle run` ejecuta un recurso ya desplegado. Una pipeline segura captura el plan, requiere aprobación para cambios destructivos y despliega el mismo artefacto validado.

La validación no ejecuta SQL ni demuestra permisos de datos del `run_as`. Después del deploy, ejecuta un smoke test con parámetros y datos acotados, comprueba estado y contrato, y sólo entonces habilita triggers o tráfico productivo. Usa `bundle summary` y output estructurado para trazabilidad.

Modelo mental

Validate, plan, deploy y run responden preguntas diferentes. Validate comprueba que la configuración compone y referencia elementos válidos; plan muestra el cambio esperado sin aplicarlo; deploy materializa recursos y artefactos; run ejecuta un recurso ya desplegado. Ninguna etapa implica automáticamente la siguiente. Un YAML válido puede describir un cambio destructivo, un despliegue correcto puede contener código defectuoso y un run exitoso puede publicar datos semánticamente erróneos. La entrega robusta coloca evidencia entre transiciones: revisión del plan, aprobación según ambiente, smoke y validación de datos. En el blueprint anterior, estas operaciones aparecen bajo Asset Bundles; en la CLI actual pertenecen a Declarative Automation Bundles y conservan el mismo razonamiento.

Validación de bundle

Comprobación estática de estructura, tipos, referencias y configuración resuelta para un target antes de modificar recursos remotos.

Detecta errores baratos temprano, aunque no garantiza seguridad del cambio ni corrección del código ejecutado.
Plan de despliegue

Representación previa de las acciones que alinearían los recursos reales con la configuración declarada del bundle.

Permite revisar actualizaciones o eliminaciones inesperadas antes de que afecten un ambiente compartido o productivo.
Smoke run

Ejecución pequeña posterior al despliegue que confirma arranque, identidad, dependencias y un recorrido crítico del recurso.

Cubre la brecha entre recursos creados correctamente y un workload realmente capaz de operar en ese ambiente.
CLISecuencia segura de promoción
databricks bundle validate -t test
databricks bundle plan -t test
databricks bundle deploy -t test
databricks bundle run -t test orders_smoke -- --business_date 2026-07-20

# Tras aprobar evidencia y el plan de prod:
databricks bundle plan -t prod
databricks bundle deploy -t prod

No uses `--force` para saltar validaciones de rama como comportamiento normal de CI.

Puntos clave

  • Validate comprueba configuración; plan anticipa cambios; deploy aplica; run verifica ejecución.
  • Revisa manualmente cambios destructivos antes de desplegar.
  • Añade smoke test post-deploy antes de activar producción.

Evita

  • Desplegar directamente en prod sin leer un plan que elimina o reemplaza recursos.
  • Confundir bundle validado con job funcional sobre datos y permisos reales.

Recuerdo activo

¿Qué aporta `bundle plan` que no aporta `bundle validate`?

Borrador privado · solo en este navegador
5 lecciones pendientes

Fuente revisada · vista externa

bundle-examples

bundle-examples · commit c1db792

default_python/src/sample_notebook.ipynb

Lectura en GitHub

Este notebook se abre desde su fuente revisada

El repositorio no permite republicar su contenido dentro de Lakehouse Lab. Conservamos la misma experiencia lateral, la ruta exacta y el commit auditado, y dejamos la lectura en GitHub para respetar la autoría.

Autor
Databricks
Licencia
Databricks License
Formato
bundle
Ver notebook en GitHub