Compartir vía


Funciones definidas por el usuario en el flujo de datos de mapeo

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Data Factory en Microsoft Fabric es la próxima generación de Azure Data Factory, con una arquitectura más sencilla, inteligencia artificial integrada y nuevas características. Si no está familiarizado con la integración de datos, comience con Fabric Data Factory. Las cargas de trabajo de ADF existentes pueden actualizarse a Fabric para acceder a nuevas funcionalidades en ciencia de datos, análisis en tiempo real e informes.

Los flujos de datos están disponibles tanto en canalizaciones de Azure Data Factory como en canalizaciones de Azure Synapse Analytics. Este artículo se aplica a los flujos de datos de mapeo. Si no está familiarizado con las transformaciones, consulte el artículo introductorio Transformación de datos mediante flujos de datos de asignación.

Una función definida por el usuario es una expresión personalizada que puedes definir para reutilizar la lógica en varios flujos de datos de mapeo. Las funciones definidas por el usuario residen en una colección denominada biblioteca de flujo de datos para poder agrupar fácilmente conjuntos comunes de funciones personalizadas.

Cada vez que cree la misma lógica en una expresión en varios flujos de datos de asignación, aproveche para convertirla en una función definida por el usuario.

Comenzar

Para empezar a trabajar con funciones definidas por el usuario, primero debe crear una biblioteca de flujo de datos. Vaya a la página de administración y luego busque las bibliotecas de flujo de datos en la sección de autor.

Captura de pantalla que muestra el panel de administración de A D F y las bibliotecas de flujo de datos.

Biblioteca de flujo de datos

Desde aquí, puede hacer clic en el botón +Nuevo para crear una nueva biblioteca de flujo de datos. Rellene el nombre y la descripción y, a continuación, está listo para crear la función definida por el usuario. Captura de pantalla que muestra el panel de creación de bibliotecas de flujo de datos.

Nueva función definida por el usuario

Para crear una función definida por el usuario, desde la biblioteca de flujo de datos en la que desea crear la función, haga clic en el botón +Nuevo. Captura de pantalla que muestra el botón Nueva función de U D F.

Rellene el nombre de la función definida por el usuario.

Nota

No puede usar el nombre de una expresión de flujo de datos de asignación existente. Para obtener una lista de las expresiones de flujo de datos de asignación actuales, consulte Expresiones de transformación de datos en el flujo de datos de asignación | Microsoft Docs

Captura de pantalla que muestra el panle de creación de nueva función de U D F.

Las funciones definidas por el usuario pueden tener cero o más argumentos. Los argumentos permiten pasar valores cuando se llama a la función y hacer referencia a esos argumentos en la lógica de expresión. Los argumentos se denominan automáticamente a partir de i1, i2, etc. y puede elegir el tipo de datos del argumento en la lista desplegable.

El cuerpo de la función definida por el usuario es donde se especifica la lógica de la función. El editor proporciona la experiencia completa del generador de expresiones completo | Microsoft Docs y le permite hacer referencia a los argumentos creados y a las expresiones de transformación de datos en el flujo de datos de asignación | Microsoft Docs.

Nota

Una función definida por el usuario no puede hacer referencia a otra.

Uso de una función definida por el usuario en el generador de expresiones

Las funciones definidas por el usuario aparecerán en el generador de expresiones de flujo de datos de mapeo en la categoría Funciones de la biblioteca de flujo de datos. Desde aquí, puede usar las funciones creadas de manera personalizada y pasar los argumentos adecuados (si los hay) que haya definido.

Captura de pantalla que muestra la biblioteca de flujo de datos en el generador de expresiones de flujo de datos de asignación.