Creación de un elemento de funciones de datos de usuario de Fabric en Visual Studio Code

Las funciones de datos de usuario de Fabric son una solución sin servidor que permite desarrollar aplicaciones de forma rápida y sencilla sobre orígenes de datos nativos de Fabric. Las ventajas son una mayor flexibilidad y rentabilidad de la informática sin servidor en Fabric. Las funciones de datos de usuario se invocan como solicitudes HTTP a un punto de conexión proporcionado por el servicio y funcionan en los orígenes de datos nativos de Fabric.

En este inicio rápido, aprenderá a crear un elemento de funciones de datos de usuario en Visual Studio (VS) Code.

Prerrequisitos

• Un área de trabajo de Fabric
• Visual Studio Code
• Python
• Azure Functions Core Tools v4
• Extensión Microsoft Fabric
• Extensión de funciones de datos de usuario

Seleccione el área de trabajo

1. Abra VS Code e inicie sesión en Fabric.

2. En Fabric, abra el área de trabajo de Fabric o cree un área de trabajo.

3. Seleccione + Nuevo elemento para abrir el panel Nuevo elemento.

4. En el panel Nuevo elemento, en Desarrollar datos, seleccione el tipo de elemento Funciones de datos de usuario.

5. Proporcione un nombre para el nuevo elemento de funciones de datos de usuario y seleccione Crear. Se crea el elemento de funciones de datos de usuario.

6. En la cinta, seleccione Python como lenguaje en tiempo de ejecución.

7. Cree un entorno virtual para este elemento de funciones de datos de usuario.

8. Seleccione la versión del runtime de Python. Para las funciones de datos de usuario se necesita la versión 3.11 de Python.

9. Seleccione Sí para establecer el entorno virtual de la carpeta.

10. Abra function_app.py para agregar más de una función.

    

Escritura de la primera función

Escriba un elemento de funciones de datos de usuario con el decorador @udf.function() para definir el inicio de la función. Puede pasar una entrada para la función, como tipos de datos primitivos como str, int, float, etc. Dentro de la función, puede escribir la lógica de negocios personalizada.

Esta es una función hello_fabric de ejemplo.

@udf.function()
def hello_fabric(name: str) -> str:
    # Use logging to write custom logs to help trace and debug issues 
    logging.info('Python UDF trigger function processed a request.')
    logging.info('Executing hello fabric function.')
    
    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!" 

Administración de funciones de datos de usuario en VS Code

Puede ver el elemento de funciones de datos de usuario en el explorador de Fabric en VS Code dentro del área de trabajo abierta actualmente.

Todas las funciones del área de trabajo de Fabric se pueden abrir en el Explorador de VS Code para empezar a editar. Elija la función que quiera abrir y, a después, seleccione Abrir en el Explorador. Puede ver conexiones, bibliotecas y todas las funciones escritas en el elemento de funciones de datos de usuario.

Administración de conexiones y bibliotecas

• Conexiones: todas las conexiones de datos agregadas para la función de datos de usuario se pueden ver desde el Explorador de Fabric. Haga clic con el botón derecho y seleccione Administrar conexiones en Fabric para los elementos de funciones de datos de usuario.

• Bibliotecas: todas las bibliotecas agregadas para la función de datos de usuario se pueden ver desde el Explorador de Fabric. Haga clic con el botón derecho y seleccione Administrar bibliotecas en Fabric para agregar nuevas bibliotecas a los elementos de funciones de datos de usuario.

• Funciones: aquí puede ver todas las funciones publicadas. Seleccione una función y realice estas acciones:

  • Ejecutar y probar para probar la función en VS Code sin tener que usar herramientas de pruebas de API.
  • Copiar dirección URL pública si esta función es accesible públicamente desde la aplicación externa.

Carpeta local para administrar las funciones de datos de usuario

El elemento de funciones de datos de usuario abierto en el explorador de VS Code es visible en la vista Carpeta local. La carpeta local le permite probar y ver los cambios locales realizados en el elemento de función de datos de usuario.

• Functions: puede ver todas las funciones que se encuentran en el archivo function_app.py local. Para empezar con un ejemplo, haga clic con el botón derecho en Funciones y seleccione Agregar una función para agregar una función de ejemplo.

  

  Para probar la función localmente, presione F5 para iniciar la depuración. También puede seleccionar el elemento de función y seleccionar Ejecutar y depurar.

• Ver conexiones y bibliotecas para la función local: puede ver todas las conexiones presentes en local.settings.json y las bibliotecas del archivo requirements.txt en el entorno local.

  • Sincronizar conexiones desde local.settings para mostrar la lista actual de conexiones en el entorno local.
  • Sincronizar requirements.txt para mostrar la lista actual de bibliotecas en el entorno local.

Publicación de la función de datos de usuario

Una vez que pruebe los cambios, publique la función de datos de usuario en Fabric. Los cambios pueden tardar unos minutos en publicarse.

Depuración local con puntos de interrupción

Presione F5 para depurar las funciones de Fabric. Puede agregar un punto de interrupción en cualquier parte del código. En el modo de depuración, los puntos de interrupción se alcanzan según lo previsto y prueban el código como se probaría una función implementada.

Pasos siguientes

• Más información sobre el modelo de programación de Funciones de datos de usuario
• Tutorial: Invocación de funciones de datos de usuario desde una aplicación de Python