Compartir a través de

Conversión de parámetros globales de Azure Data Factory en bibliotecas de variables de Fabric Data Factory

Microsoft Fabric usa bibliotecas de variables en áreas de trabajo para definir constantes entre canalizaciones y otros elementos de Data Factory y Fabric. Puede migrar parámetros globales de ADF a bibliotecas de variables de Fabric con algunos pasos manuales.

Esta guía le guía por el proceso:

  • Exportación de los parámetros globales de ADF
  • Creación de variables de área de trabajo en Fabric
  • Actualizar expresiones de canalización
  • Validar el comportamiento

Descripción de la biblioteca de variables de Fabric

La biblioteca de variables de Fabric almacena valores a nivel de entorno de trabajo a los que puede referirse en flujos de trabajo y actividades. Admite tipos como cadena, número y booleano, además de valores seguros para secretos. Puede versionar bibliotecas de variables e implementarlas a través de entornos con canalizaciones de implementación.

A diferencia de los parámetros globales de ADF, las variables de Fabric ofrecen una seguridad más estricta, una reutilización más sencilla y un mejor control de gobernanza. Puede aplicarlos en todos los elementos de Fabric. Para obtener más información, consulte Introducción a las bibliotecas de variables.

Migración de parámetros globales de ADF a la biblioteca de variables de Fabric

  1. Exporte los parámetros globales de ADF.

    1. En Azure Data Factory Studio, vaya a Administración> deparámetros globales. Registre el nombre, el tipo y el valor de cada parámetro.
    2. Para migraciones de gran tamaño, vaya a Administración> deplantillas de ARM y exportación de plantillas de ARM para extraer parámetros mediante programación. Puede encontrarlos en la carpeta de plantillas, dentro de la carpeta factory, en el archivo que termina en ParametersForFactory

  2. Compare los tipos disponibles.

    Revise los tipos de parámetros globales de ADF (string, int, bool, etc.) y compárelos con los tipos de biblioteca de variables de Fabric. Tome nota de cualquier diferencia de tipo que pueda requerir ajustes durante la migración.

  3. Cree una biblioteca de variables en Fabric.

    1. En el espacio de trabajo de Fabric, seleccione + Nuevo ítem y luego busque y seleccione Biblioteca de variables.
    2. Cree una biblioteca (por ejemplo, GlobalParams).
    3. Abra la nueva biblioteca de variables, seleccione +Nueva variable y cada parámetro global de ADF como variable.

    Para obtener más información sobre cómo crear bibliotecas de variables, consulte Introducción a las bibliotecas de variables.

  4. Actualice las expresiones de canalización migradas.

    Actualice referencias de parámetros globales como @globalParameters('ParamName') a referencias de biblioteca de variables como @pipeline.libraryVariables.ParamName.

    Actualice todas las expresiones de actividad, las cadenas de conexión, los argumentos de script, la lógica de filtro y las propiedades del conjunto de datos. Para más información, consulte Integración de bibliotecas de variables con canalizaciones de datos.

  5. Validar el comportamiento de la canalización.

    Ejecute ejecuciones de validación y pruebas para confirmar que las variables se resuelven correctamente en las canalizaciones. Compruebe que las conexiones, los enlaces de parámetros y el uso seguro de variables funcionan según lo previsto.

Patrones comunes de migración

Estos son algunos patrones de migración que puede usar al convertir parámetros globales en bibliotecas de variables:

  • Asignación directa — Los parámetros simples de ADF, como la región o el nombre del arrendatario, mapean uno a uno a las entradas de la biblioteca de variables.

  • Bibliotecas específicas del entorno : en lugar de una biblioteca, cree varias bibliotecas (Global-Dev, Global-Test, Global-Prod). Las canalizaciones de implementación pueden enlazar la biblioteca correcta en función del entorno.

  • Modelo híbrido : mantenga constantes compartidas en la biblioteca de variables, pero pase información específica de la ejecución a través de parámetros de canalización.

Limitaciones actuales

Actualmente, hay algunas limitaciones que debe tener en cuenta:

  • La herramienta de migración de PowerShell de Azure Data Factory a Microsoft Fabric no migra automáticamente los parámetros globales.
  • Las expresiones dentro de servicios vinculados o canalizaciones que hacen referencia a @globalParameters() no se vuelven a escribir automáticamente.
  • Las conexiones de Fabric (el reemplazo de los servicios vinculados de Azure Data Factory) no admiten las expresiones de parámetro de la misma manera. Debe volver a crear manualmente los parámetros dinámicos que se usan en las definiciones de conexión.

procedimientos recomendados

Tenga en cuenta estas sugerencias:

  • Alinee las convenciones de nomenclatura antes de la migración.
  • Evite sobrecargar variables de nivel de área de trabajo. Use parámetros de canalización para los valores en tiempo de ejecución en su lugar.
  • Use canalizaciones de implementación para administrar bibliotecas de variables específicas del entorno.
  • Documente la biblioteca de variables para que los miembros del equipo sepan qué pipelines dependen de cuáles variables.

Contenido relacionado

  • Last updated on