Configuración de parámetros del trabajo

Configure los parámetros de trabajo en la interfaz de usuario del área de trabajo de Azure Databricks o agréguelos a las definiciones JSON y YAML que se usan con la API REST, la CLI y los conjuntos de automatización declarativa. Consulte API de trabajos, CLI de Databricks y ¿Qué son los paquetes de automatización declarativa?.

¿Qué son los parámetros de un trabajo?

Los parámetros de trabajo son pares clave-valor que permiten parametrizar trabajos con valores estáticos o dinámicos predeterminados. Opcionalmente, puede invalidar los parámetros configurados en un trabajo al desencadenar una nueva ejecución. Consulte Ejecución de un trabajo con parámetros diferentes.

Las claves de parámetro del trabajo solo pueden contener caracteres _ - . o alfanuméricos. Los valores de parámetro se establecen como cadenas o referencias de valores dinámicos. Consulte Referencias de valores dinámicos.

Nota:

Un valor de parámetro de trabajo puede ser cualquier JSON válido, incluidas las matrices. Para ver cómo las tareas consumen parámetros de matriz JSON, consulte Configuración de parámetros de tarea.

Adición o edición de parámetros de trabajo

Use el cuadro de diálogo Parámetros de trabajo para agregar nuevos parámetros, editar valores y claves de parámetro existentes o eliminar parámetros.

Para editar parámetros con la interfaz de usuario del área de trabajo, seleccione un trabajo existente mediante los pasos siguientes:

  1. En la barra lateral del área de trabajo de Azure Databricks, haga clic en Jobs & Pipelines.
  2. Opcionalmente, seleccione los filtros Trabajos y Propiedad de mí .
  3. Haga clic en el vínculo Nombre del trabajo.
  4. En la barra lateral Detalles del trabajo, haga clic en Editar parámetros. Aparece el cuadro de diálogo Parámetros de trabajo.
  5. Agregue o edite parámetros mediante campos Clave y Valor.
  6. Haga clic en Papelera para eliminar un parámetro.
  7. Haga clic en Guardar para aplicar los cambios.

Nota:

Haga clic en { } para enumerar las referencias de valores dinámicos disponibles. Seleccione una opción de la lista para insertarla en el campo Valor.

Inserción de parámetros de trabajo

Los parámetros del trabajo se transmiten a los distintos tipos de tareas de diferentes maneras. Para comprender cómo se pasan y cómo acceder a ellos dentro de la tarea, consulte Acceso a los valores de parámetro desde una tarea.

Importante

En el caso de las tareas que admiten parámetros clave-valor, los parámetros del trabajo se transmiten automáticamente; si un parámetro del trabajo y un parámetro de la tarea comparten una clave, prevalece el parámetro del trabajo. Las tareas que toman parámetros de matriz JSON no reciben parámetros de trabajo automáticamente; haga referencia a ellos explícitamente con {{job.parameters.<name>}}. Consulte Configure task parameters (Configuración de parámetros de tarea).

Ejecución de un trabajo con parámetros diferentes

Puede invalidar los parámetros de trabajo configurados, o bien agregar otros nuevos al ejecutar un trabajo con otros parámetros. Consulte Ejecución de un trabajo con una configuración diferente.

También puede invalidar los parámetros de trabajo al reparar una ejecución de un trabajo. Consulte Error en la repetición de la ejecución y tareas omitidas.

  • Last updated on