Parámetros globales en Azure Data Factory

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. Obtenga más información sobre cómo iniciar una nueva evaluación gratuita.

Los parámetros globales son constantes en una factoría de datos que una canalización puede consumir en cualquier expresión. Resultan útiles cuando se tienen varias canalizaciones con nombres y valores de parámetros idénticos. Al promover una factoría de datos mediante el proceso de integración e implementación continuas (CI/CD), puede invalidar estos parámetros en cada entorno.

Creación de parámetros globales

Para crear un parámetro global, vaya a la pestaña Parámetros globales de la sección Administrar. Seleccione Nuevo para abrir el panel de navegación lateral de creación.

En el panel de navegación lateral, escriba un nombre, seleccione un tipo de datos y especifique el valor del parámetro.

Una vez creado un parámetro global, puede editarlo con un clic en el nombre del parámetro. Para modificar varios parámetros a la vez, seleccione Editar todo.

Uso de parámetros globales en una canalización

Los parámetros globales se pueden usar en cualquier expresión de canalización. Si una canalización hace referencia a otro recurso, como un conjunto de datos o un flujo de datos, puede pasar el valor del parámetro global a través de los parámetros de ese recurso. Se hace referencia a los parámetros globales como pipeline().globalParameters.<parameterName>.

Parámetros globales en CI/CD

Se recomienda incluir parámetros globales en la plantilla de ARM durante la CI/CD. El nuevo mecanismo de inclusión de parámetros globales en la plantilla de ARM (desde "Centro de administración" -> "Plantilla de ARM" -> "Incluir parámetros globales en la plantilla de ARM"), como se muestra a continuación, no entrará en conflicto ni invalidará la configuración de nivel de fábrica como pasaba antes, por lo que no se requiere PowerShell adicional para la implementación de parámetros globales durante CI/CD.

Nota:

Hemos movido la experiencia de la interfaz de usuario para incluir parámetros globales de la sección "Parámetros globales" en la sección "Plantilla de ARM" del centro de administración. Si ya usa el mecanismo anterior (desde "Centro de administración" -> "Parámetros globales" -> "Incluir en la plantilla de ARM"), puede continuar. Seguiremos admitiéndolo.

Si usa el flujo anterior de integración de parámetros globales en la solución de integración e implementación continuas, seguirá funcionando:

• Incluya parámetros globales en la plantilla de ARM (desde "Centro de administración" -> "Parámetros globales" -> "Incluir en plantilla de ARM")

• Implementar los parámetros globales mediante un script de PowerShell

Se recomienda encarecidamente usar el nuevo mecanismo de inclusión de parámetros globales en la plantilla de ARM (desde "Centro de administración" -> "Plantilla de ARM" -> "Incluir parámetros globales en la plantilla de ARM"), ya que hace que la CICD con parámetros globales sea mucho más sencilla y fácil de administrar.

Nota:

La configuración Incluir parámetros globales en una plantilla de ARM solo está disponible en el "modo Git". Actualmente está deshabilitada en el" modo activo" o el modo de "Data Factory".

Advertencia

No se puede usar "-" en el nombre del parámetro. Recibirá un código de error "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=La expresión >'pipeline().globalParameters.myparam-dbtest-url' no es válida: .....}". Sin embargo, puede usar "_" en el nombre del parámetro.

Contenido relacionado

• Más información sobre el proceso de integración e implementación continuas de Azure Data Factory.
• Más información sobre cómo usar el lenguaje de expresiones del flujo de control.