Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las funciones de datos de usuario te permiten crear funciones reutilizables en Python que puedes llamar desde Fabric y desde aplicaciones externas. Escribe tu lógica de negocio una vez y llámala desde pipelines, notebooks, reglas de activadores, flujos de tareas translíticos de Power BI o cualquier sistema externo a través de endpoints REST.
Las funciones de datos de usuario proporcionan un entorno de proceso sin servidor donde puede hospedar y ejecutar código de Python personalizado directamente en Fabric. Tanto si necesita estandarizar categorías de productos, aplicar reglas de negocio complejas o integrarse con API externas, puede escribir funciones que estén disponibles inmediatamente en toda la plataforma de datos. El servicio admite el entorno de ejecución de Python 3.11.9, las bibliotecas públicas de PyPI y las conexiones de datos de Fabric.
¿Listo para empezar? Siga esta guía para crear un elemento de funciones de datos de usuario o usar la extensión de VS Code.
¿Por qué usar las funciones de datos de usuario de Fabric?
Las funciones de datos de usuario de Fabric proporcionan una plataforma serverless para alojar tu lógica personalizada e invocarla desde diferentes tipos de elementos y fuentes de datos de Fabric. Utiliza este servicio para escribir lógica de negocio, algoritmos internos y funciones reutilizables que se integren en tus soluciones Fabric.
A continuación se muestran las principales ventajas:
- Reutilización: Escribe tu lógica de negocio una vez como función de datos de usuario e invócala desde varios elementos de Fabric: pipelines, notebooks, reglas activadoras y flujos de tareas translíticos de Power BI. Cuando cambien las reglas de negocios, actualice la función una vez en lugar de modificar el código en varios lugares.
- Hospedaje sin servidor: implemente funciones de Python sin administrar la infraestructura. Las funciones de datos de usuario proporcionan un entorno computacional sin servidor con autenticación incorporada, por lo que no necesitas configurar ni mantener servicios API o contenedores separados.
- Conectividad externa: cada función expone automáticamente su propio punto de conexión REST único, lo que permite la integración con aplicaciones externas, servicios web y clientes personalizados. Llame a las funciones desde cualquier sistema que admita solicitudes HTTP.
Funcionalidades clave
- Escribe una vez, ejecuta en cualquier lugar: Crea funciones que funcionen idénticamente, ya sea invocadas desde pipelines, cuadernos, reglas de activación, Power BI o llamadas REST externas
- Ecosistema de Python enriquecido: use cualquier paquete de PyPI para crear lógica sofisticada: pandas para la manipulación de datos, solicitudes de llamadas API o bibliotecas especializadas para el dominio
- Acceso seguro a los datos: Conectarse a fuentes de datos Fabric (bases de datos SQL, almacenes, casas de lago, bases de datos espejadas) con autenticación y seguridad integradas
- Desarrollo y publicación de flujo de trabajo: pruebe las funciones antes de publicarlas, lo que garantiza que los cambios se validan antes de estar disponibles para la invocación.
Funcionalidades de integración
Las funciones de datos de usuario se integran perfectamente con cargas de trabajo Fabric y sistemas externos, permitiéndote construir soluciones de datos completas.
Invocar desde elementos de Fabric
Llame a sus funciones desde cualquier tarea de Fabric para centralizar la lógica empresarial y mantener la coherencia.
- Canalizaciones de datos - Ejecutan funciones como actividades de canalización para transformaciones de datos, validaciones o lógica de orquestación
- Cuadernos : invocación de funciones desde cuadernos de PySpark o Python para flujos de trabajo de ciencia de datos y análisis exploratorio
- Reglas del activador : desencadena funciones en respuesta a eventos en tiempo real y datos de streaming
- Power BI flujos de tareas translíticos: llame a funciones directamente desde informes de Power BI para experiencias de datos interactivas. Las funciones de datos de usuario pueden recibir el contexto del informe —como el filtro actual y el contexto de selección— en la carga útil de la solicitud, permitiendo la ejecución de acciones y escenarios de escritura desde dentro de un informe. Una vez completada la reescritura, la visibilidad de los datos del informe depende del modo de almacenamiento del informe y la semántica de actualización: los valores actualizados aparecen inmediatamente para los informes de Direct Lake o DirectQuery, o después de una actualización automática desencadenada por el flujo de tareas para los informes en modo de importación.
Conexión a orígenes de datos de Fabric
Las funciones pueden acceder de forma segura a los datos desde toda la plataforma de Fabric:
- Bases de datos SQL - Operaciones de lectura y escritura en bases de datos SQL en Fabric
- Almacenes : operaciones de lectura y escritura para datos estructurados
- Lakehouses - Leer y escribir archivos de Lakehouse; acceso de solo lectura a los puntos de conexión de SQL Analytics
- Bases de datos reflejadas : acceso de solo lectura a los datos de base de datos reflejados
- Biblioteca de variables - Accede a una configuración centralizada en forma de variables para tus funciones.
- Cosmos DB en Fabric - Conectarse a Cosmos DB en contenedores Fabric para operaciones de datos NoSQL.
- Eventos empresariales - Detectar cambios en los datos operativos y publicar eventos empresariales para aplicaciones posteriores.
Además de las conexiones gestionadas, las funciones de datos de usuario soportan conexiones genéricas que puedes usar para conectar a elementos de Fabric o recursos de Azure usando la identidad del propietario del elemento. Las conexiones genéricas generan un token Microsoft Entra ID con la identidad del propietario para un tipo de audiencia especificado, proporcionando una forma flexible de autenticarse con servicios como Azure Cosmos DB o Azure Key Vault sin necesidad de configurar conexiones gestionadas individuales. Para más información, consulte Conexiones genéricas para elementos de Fabric o recursos de Azure.
La escritura de retorno desde flujos de tareas translíticos de Power BI es compatible de forma nativa al invocar funciones de datos de usuario. Las funciones de datos de usuario pueden realizar operaciones de añadir, actualizar y eliminar bases de datos SQL en Fabric, almacenes y archivos lakehouse, lo que las convierte en el punto ideal de integración para escenarios de escritura impulsados por flujo de tareas.
Obtenga más información sobre cómo conectarse a orígenes de datos de Fabric.
Llamada desde aplicaciones externas
Cada función de datos de usuario expone automáticamente su propio punto final REST único para su integración con sistemas fuera de Fabric:
- Aplicaciones web : invocación de funciones desde aplicaciones web, aplicaciones móviles o aplicaciones de página única
- Serviciosexternales: integración con sistemas externos, microservicios o aplicaciones heredadas, por ejemplo, publicar mensajes o actualizaciones en Microsoft Teams o llamar a api REST externas como parte de acciones controladas por flujos de tareas
- Flujos de trabajo de API : encadenar funciones con otras API para crear escenarios de integración complejos
- Clientes personalizados : llamada desde cualquier lenguaje de programación o plataforma que admita solicitudes HTTP
Los puntos finales REST para funciones de datos de usuario soportan autenticación Microsoft Entra ID, asegurando acceso seguro desde sistemas externos. Aprende a invocar funciones de datos de usuario desde una aplicación en Python.
Comienza
¿Listo para crear tus primeras funciones de datos de usuario? Elija su entorno de desarrollo preferido:
- Creación de funciones en el portal de Fabric : guía de inicio rápido con desarrollo y pruebas basados en explorador
- Desarrollo con Visual Studio Code: experiencia completa del IDE con la depuración local y la integración de Git
Contenido relacionado
- Modelo de programación de funciones de datos de usuario - Profundiza en el SDK de Python, los decoradores y las funciones avanzadas
- Invocación de funciones desde una aplicación de Python : aprenda a llamar a las funciones a través de puntos de conexión REST desde sistemas externos.