Convertir los 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 factoría de datos y Fabric. Puede migrar parámetros globales de ADF a Fabric bibliotecas de variables 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 Fabric almacena valores de nivel de área de trabajo a los que puede hacer referencia en canalizaciones 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, Fabric variables ofrecen una mayor seguridad, reutilización más sencilla y mejores controles 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 Fabric biblioteca de variables

  1. Exporte los parámetros globales de ADF.

    1. En Azure Data Factory Studio, vaya a Manage>Global Parameters. 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 Fabric tipos de biblioteca de variables. Tome nota de cualquier diferencia de tipo que pueda requerir ajustes durante la migración.

  3. Crear una biblioteca de variables en Fabric.

    1. En el área de trabajo de Fabric, seleccione + Nuevo elemento y busque y seleccione Bibliotecavariable.
    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:

  • Ni la experiencia de actualización integrada ni la herramienta de migración de PowerShell migran 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.
  • Conexiones de Fabric (el reemplazo de los servicios vinculados de Azure Data Factory) no admiten expresiones de parámetro de la manera habitual. 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