Quali sono le funzioni dati utente di Fabric?

Le funzioni dati utente ti permettono di creare funzioni Python riutilizzabili che puoi chiamare da Fabric e da applicazioni esterne. Scrivi la tua logica di business una volta e chiamala da pipeline, notebook, regole attivatorie, flussi di task translitici Power BI o qualsiasi sistema esterno tramite endpoint REST.

Le funzioni dati utente forniscono un ambiente di calcolo serverless in cui è possibile ospitare ed eseguire codice di Python personalizzato direttamente in Fabric. Sia che sia necessario standardizzare le categorie di prodotti, applicare regole business complesse o integrarsi con LE API esterne, è possibile scrivere funzioni immediatamente disponibili nell'intera piattaforma dati. Il servizio supporta il runtime Python 3.11.9, le librerie pubbliche da PyPI e le connessioni dati di Fabric.

Sei pronto per iniziare? Seguire questa guida per creare un nuovo elemento delle funzioni per i dati utente o utilizzare l'estensione di Visual Studio Code.

Perché usare le funzioni dati utente di Fabric?

Le funzioni dati utente Fabric offrono una piattaforma serverless per ospitare la tua logica personalizzata e invocarla da diversi tipi di elementi e fonti di dati Fabric. Usa questo servizio per scrivere logica di business, algoritmi interni e funzioni riutilizzabili che si integrano nelle tue soluzioni Fabric.

Di seguito sono riportati i vantaggi principali:

• Riutilizzabilità: Scrivi la tua logica aziendale una volta come funzione dati utente e richiamala da più elementi Fabric - pipeline, notebook, regole attivatorie e flussi di task translitici di Power BI. Quando le regole business cambiano, aggiornare la funzione una sola volta anziché modificare il codice in più posizioni.
• Hosting serverless: distribuire funzioni Python senza gestire l'infrastruttura. Le funzioni dati utente forniscono un ambiente di calcolo serverless con autenticazione integrata, quindi non è necessario configurare e mantenere servizi API o container separati.
• Connettività esterna: ogni funzione espone automaticamente il proprio endpoint REST univoco, consentendo l'integrazione con applicazioni esterne, servizi Web e client personalizzati. Chiamare le funzioni da qualsiasi sistema che supporti le richieste HTTP.

Funzionalità chiave

• Scrivi una volta, esegui ovunque: crea funzioni che funzionino allo stesso modo, sia che vengano invocate da pipeline, notebook, regole attivatorie, Power BI o chiamate REST esterne
• Ecosistema Python avanzato: usare qualsiasi pacchetto di PyPI per creare logica sofisticata, pandas per la manipolazione dei dati, le richieste di chiamate API o librerie specializzate per il dominio
• Accesso sicuro ai dati: Connettiti a fonti dati Fabric (database SQL, magazzini, lakehouse, database speculari) con autenticazione e sicurezza integrate
• Sviluppare e pubblicare il flusso di lavoro: testare le funzioni prima di pubblicarle, assicurandosi che le modifiche vengano convalidate prima di diventare disponibili per la chiamata

Funzionalità di integrazione

Le funzioni dati utente si integrano perfettamente con i carichi di lavoro Fabric e i sistemi esterni, permettendoti di costruire soluzioni dati complete.

Richiamare da elementi del Fabric

Chiamare le funzioni da qualsiasi carico di lavoro di Fabric per centralizzare la logica di business e mantenere la coerenza:

• Pipeline dati - Eseguono funzioni come attività pipeline per trasformazioni di dati, validazioni o logica di orchestrazione
• Notebook: richiamare funzioni da notebook PySpark o Python per i flussi di lavoro di data science e l'analisi esplorativa
• Regole di attivazione - Attivare funzioni in risposta a eventi in tempo reale e dati di streaming
• Power BI flussi di attività translitici - Chiamare le funzioni direttamente dai report Power BI per esperienze interattive di dati. Le funzioni dati utente possono ricevere il contesto del report - come il filtro corrente e il contesto di selezione - nel payload della richiesta, consentendo l'esecuzione di azioni e scenari di write-back all'interno di un report. Al termine del writeback, la visibilità dei dati nel report dipende dalla modalità di archiviazione e dalla semantica di aggiornamento del report: i valori aggiornati vengono visualizzati immediatamente per i report Direct Lake o DirectQuery o dopo un aggiornamento automatico attivato dal flusso di attività per i report in modalità importazione.

Connettersi alle origini dati di Fabric

Le funzioni possono accedere in modo sicuro ai dati da tutta la piattaforma Fabric:

• Database SQL - Operazioni di lettura e scrittura su database SQL in Fabric
• Magazzini - Operazioni di lettura e scrittura su dati strutturati
• Lakehouses - Leggere e scrivere file Lakehouse; accesso in sola lettura agli endpoint di analisi SQL
• Database con mirroring - Accesso in sola lettura ai dati del database con mirroring
• Libreria variabile - Accedi alle impostazioni di configurazione centralizzate come variabili nelle tue funzioni.
• Cosmos DB in Fabric - Collegati a Cosmos DB in container Fabric per operazioni dati NoSQL.
• Eventi aziendali - Rilevare cambiamenti nei dati operativi e pubblicare eventi aziendali per applicazioni a valle.

Oltre alle connessioni gestite, le funzioni dati utente supportano connessioni generiche che puoi utilizzare per collegarti a elementi Fabric o risorse Azure usando l'identità del proprietario dell'elemento. Le connessioni generiche generano un token Microsoft Entra ID con l'identità del proprietario per un tipo di pubblico specificato, offrendo un modo flessibile per autenticarsi con servizi come Azure Cosmos DB o Azure Key Vault senza configurare singole connessioni gestite. Per ulteriori informazioni, consulta Connessioni generiche per elementi Fabric o risorse Azure.

La scrittura da flussi di task translitici di Power BI è supportata nativamente quando si invocano funzioni dati utente. Le funzioni dati utente possono eseguire operazioni di aggiunta, aggiornamento ed eliminazione su database SQL in Fabric, warehouse e file lakehouse, rendendoli il punto di integrazione ideale per scenari di write-back basati sul flusso di attività.

Scopri di più sulla connessione alle origini dati di Fabric.

Chiamare da applicazioni esterne

Ogni funzione dati utente espone automaticamente il proprio endpoint REST unico per l'integrazione con sistemi esterni a Fabric:

• Applicazioni Web : richiamare funzioni da app Web, app per dispositivi mobili o applicazioni a pagina singola
• Servizi esterni - Integrare con sistemi esterni, microservizi o applicazioni legacy, ad esempio inviare messaggi o aggiornamenti a Microsoft Teams o chiamare API REST esterne come parte di azioni guidate dal flusso di attività
• Flussi di lavoro dell'API - Concatenare le funzioni con altre API per creare scenari di integrazione complessi
• I client personalizzati - chiamare tramite qualsiasi linguaggio di programmazione o piattaforma che supporta le richieste HTTP

Gli endpoint REST per le funzioni dati utente supportano l'autenticazione Microsoft Entra ID, garantendo un accesso sicuro da sistemi esterni. Impara come evocare funzioni dati utente da un'applicazione Python.

Get started

Pronto a creare le tue prime funzioni dati utente? Scegliere l'ambiente di sviluppo preferito:

• Creare funzioni nel portale di Fabric - Guida rapida con sviluppo e test basati su browser
• Sviluppare con Visual Studio Code - Esperienza IDE completa con il debug locale e l'integrazione git

Contenuti correlati

• Modello di programmazione delle funzioni dati utente - Approfondimento dell'SDK Python, dei decorator e delle funzionalità avanzate
• Richiamare le funzioni da un'applicazione Python : informazioni su come chiamare le funzioni tramite endpoint REST da sistemi esterni