Convertir los parámetros globales de Azure Data Factory en bibliotecas de variables de Fabric Data Factory

Fabric usa bibliotecas de variables en los espacios de trabajo para definir constantes en canalizaciones y otros elementos de Data Factory y de Fabric. Puedes migrar los parámetros globales de Azure Data Factory a bibliotecas de variables de Fabric con unos pocos pasos manuales.

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

  • Exporta tus parámetros globales de Azure Data Factory
  • 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 en Fabric almacena valores a nivel de espacio de trabajo que puedes consultar entre pipelines 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 Azure Data Factory, las variables Fabric ofrecen una seguridad más estricta, una reutilización más fácil 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.

Migrar parámetros globales de Azure Data Factory a la biblioteca de variables Fabric

  1. Exporta tus parámetros globales de Azure Data Factory.

    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.

    Revisa los tipos globales de parámetros de Azure Data Factory (string, int, bool, etc.) y compáralos con los tipos de bibliotecas de variables de Fabric. 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. Abre tu nueva biblioteca de variables, selecciona +Nueva variable y cada parámetro global de Azure Data Factory 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:

  • Mapeo directo — Los parámetros simples de Azure Data Factory, como la región o el nombre del inquilino, se corresponden uno a uno con 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 actualización de PowerShell actualizan 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

  • Se actualizó por última vez el