Creare un elemento di funzioni dati utente di Fabric in Visual Studio Code

Le funzioni dati utente di Fabric sono una soluzione serverless che consente di sviluppare applicazioni in modo rapido e semplice su origini dati native dell'infrastruttura. I vantaggi sono la maggiore flessibilità e l'efficacia dei costi dell'elaborazione serverless in Fabric. Le funzioni per i dati utente vengono richiamate come richieste HTTP a un endpoint fornito dal servizio e operano sulle origini dati native di Fabric.

In questa guida introduttiva, apprenderai come creare un elemento di funzioni dati utente in Visual Studio (VS) Code.

Prerequisiti

• Un’area di lavoro Fabric
• Visual Studio Code
• Python
• Azure Functions Core Tools v4
• Estensione di Microsoft Fabric
• Estensione delle funzioni dati utente

Seleziona l'area di lavoro

1. Apri VS Code e accedi a Fabric.

2. In Fabric, apri l'area di lavoro Fabric o crea una nuova area di lavoro.

3. Seleziona + Nuovo elemento, per aprire il riquadro Nuovo elemento.

4. Nel riquadro Nuovo elemento, in Sviluppare dati, seleziona il tipo di elemento Funzioni dati utente.

5. Specifica un nome per il nuovo elemento delle funzioni dati utente e seleziona Crea. Viene creato il nuovo elemento delle funzioni dati utente.

6. Nella barra multifunzione selezionare Python come linguaggio di runtime.

7. Crea un ambiente virtuale per questo elemento di funzioni dati utente.

8. Seleziona la versione del runtime python. Le funzioni dati utente richiedono Python versione 3.11.

9. Imposta l'ambiente virtuale per la cartella selezionando Sì.

10. Apri function_app.py per aggiungere più funzioni.

    

Scrivi la prima funzione

Scrivi un elemento di funzioni per dati utente con il decoratore @udf.function() per definire l'inizio della funzione. È possibile passare un input per la funzione, ad esempio tipi di dati primitivi come str, int, float e così via. All'interno della funzione è possibile scrivere la logica di business personalizzata.

Ecco un esempio di funzione hello_fabric.

@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()}!" 

Gestire funzioni per i dati utente in VS Code

È possibile visualizzare l'elemento delle funzioni dati utente in Esplora infrastrutture in VS Code all'interno dell'area di lavoro attualmente aperta.

Tutte le funzioni nell'area di lavoro Fabric possono essere aperte in Esplora di VS Code per avviare la modifica. Scegli la funzione che vuoi aprire, quindi seleziona Apri in Esplora risorse. Puoi visualizzare connessioni, librerie e tutte le funzioni scritte nell'elemento delle funzioni dati utente.

Gestire connessioni e librerie

• Connessioni: tutte le connessioni dati aggiunte per la funzione dati utente possono essere visualizzate da Fabric Explorer. Fai clic con il pulsante destro del mouse e seleziona Gestisci connessioni in Fabric per gli elementi delle funzioni dati utente.

• Librerie: tutte le librerie aggiunte per l'elemento delle funzioni dati utente possono essere visualizzate da Fabric Explorer. Fai clic con il pulsante destro del mouse e seleziona Gestisci librerie in Fabric per aggiungere nuove librerie per gli elementi delle funzioni dati utente.

• Funzioni: è possibile visualizzare tutte le funzioni pubblicate qui. Seleziona una funzione ed eseguire queste azioni:

  • Esegui e testa la funzione in VS Code senza dover usare gli strumenti di test dell'API.
  • Copia l'URL pubblico se questa funzione è accessibile pubblicamente richiama dall'applicazione esterna.

Cartella locale per gestire le funzioni dei dati utente

L'elemento delle funzioni dati dell'utente aperto in VS Code Explorer è visibile nella visualizzazione Cartella locale. La cartella locale consente di testare e visualizzare le modifiche locali apportate all'elemento della funzione dati utente.

• Funzioni: è possibile visualizzare tutte le funzioni presenti nel file locale function_app.py. Per iniziare con un esempio, fai clic con il pulsante destro del mouse su Funzioni e seleziona Aggiungi una funzione per aggiungere una funzione di esempio.

  

  Per testare la funzione in locale, premi F5 per avviare il debug. Puoi anche selezionare l'elemento della funzione e selezionare Avvia ed esegui debug.

• Visualizzare connessioni e librerie per la funzione locale: è possibile visualizzare tutte le connessioni presenti in local.settings.json e le librerie nel file requirements.txt nell'ambiente locale.

  • Sincronizzare le connessioni da local.settings per visualizzare l'elenco corrente delle connessioni nell'ambiente locale.
  • Sincronizzare requirements.txt per visualizzare l'elenco corrente di librerie nell'ambiente locale.

Pubblicare la funzione Dati utente

Dopo aver testato le modifiche, pubblica la funzione dati utente in Fabric. La pubblicazione delle modifiche può richiedere alcuni minuti.

Debug locale con punti di interruzione

Seleziona F5 per eseguire il debug delle tue funzioni Fabric. Puoi impostare un punto di interruzione in qualsiasi posizione all'interno del codice. In modalità di debug, i punti di interruzione vengono raggiunti come previsto e si testa il codice come si testerebbe una funzione distribuita.

Passaggi successivi

• Altre informazioni sul modello di programmazione delle funzioni per i dati utente
• Esercitazione: Richiamare le funzioni dei dati utente da un'applicazione Python