Configuración de parámetros del trabajo
En este artículo se describe la funcionalidad del parámetro de trabajo y la configuración de parámetros de trabajo con la interfaz de usuario del área de trabajo de Databricks. También puede agregar parámetros de trabajo a definiciones JSON y YAML que se usan con la API de REST, la CLI y los DAB. Consulte API de trabajos, ¿Qué es la CLI de Databricks? y ¿Qué son los conjuntos de recursos de Databricks?.
¿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 ¿Qué es una referencia de valores dinámicos?.
Nota:
Puede usar cualquier JSON válido como valor de parámetro. Por ejemplo, el tipo de tarea For each puede analizar listas como las siguientes:
[1, 2, 3]
['a', 'b', 'c']
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:
- Haga clic en
Flujos de trabajo en la barra lateral. - En la columna Name (Nombre), haga clic en el nombre de trabajo.
- En la barra lateral Detalles del trabajo, haga clic en Editar parámetros. Aparece el cuadro de diálogo Parámetros de trabajo.
- Agregue o edite parámetros mediante campos Clave y Valor.
- Haga clic en
para quitar un parámetro. - 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 de trabajo se insertan automáticamente como parámetros clave-valor en todas las tareas que aceptan parámetros clave-valor, que incluyen los siguientes tipos de tareas:
- Notebook
- Wheel de Python (solo cuando se configura con argumentos de palabra clave)
- Consulta SQL, panel heredado o archivo
- Ejecución de trabajo
Los parámetros de trabajo pasados a las tareas son visibles en la configuración de la tarea en la interfaz de usuario junto con los parámetros configurados en la tarea.
Importante
Los parámetros de trabajo tienen prioridad sobre los parámetros de tarea. Si un parámetro de trabajo y un parámetro de tarea tienen la misma clave, el parámetro de trabajo invalida el parámetro de tarea.
Referencias de valores dinámicos a los parámetros de trabajo
Todas las tareas que aceptan referencias de valores dinámicos pueden tener acceso a los parámetros de trabajo.
Use la referencia de valores dinámicos {{job.parameters.<name>}}, que reemplaza <name> por key que identifica el parámetro.
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 parámetros diferentes.
También puede invalidar los parámetros de trabajo al reparar una ejecución de trabajo. Consulte Error en la repetición de la ejecución y tareas omitidas.