Che cos'è Fabric User data functions?

Le funzioni dati utente consentono di creare funzioni di Python riutilizzabili che possono essere richiamate tra Microsoft Fabric e da applicazioni esterne. Scrivi la logica di business una sola volta e chiamala da Pipeline, Notebook, regole di Attivazione, Power BI task flow translytical o da 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 di Fabric offrono una piattaforma serverless per ospitare le funzionalità personalizzate e richiamarle da vari elementi e fonti di dati di Fabric. È possibile usare questo servizio per scrivere logica di business, algoritmi interni e funzioni riutilizzabili che si integrano nelle soluzioni fabric.

Di seguito sono riportati i vantaggi principali:

• Reusability: scrivere la logica aziendale una sola volta come Funzione dei Dati dell'Utente e utilizzarla in diversi elementi di Fabric: Pipelines, Notebooks, regole di Activator e flussi di attività translytical 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 predefinita, eliminando la necessità di configurare e gestire contenitori o servizi API 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

• Scrivere una sola volta, eseguire ovunque: creare funzioni che funzionano in modo identico se richiamate da pipeline, notebook, regole di attivazione, 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: connettersi a origini dati di Fabric (database SQL, magazzini di dati, archivi di dati integrati, database con mirroring) con un'autenticazione e sicurezza predefinite
• 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

Funzioni dati utente si integrano perfettamente con i carichi di lavoro di Microsoft Fabric e i sistemi esterni, consentendo di creare soluzioni di 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 di dati - Eseguire funzioni come attività della pipeline per trasformazioni, convalide o logica di orchestrazione dei dati
• 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. Funzioni dati degli utenti possono ricevere il contesto del report, come il contesto di filtro e selezione corrente, nel payload della richiesta, abilitando l'esecuzione di azioni e scenari di write-back dall'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 nei database SQL dell'infrastruttura
• Magazzini - Operazioni di lettura e scrittura su dati strutturati
• Lakehouses - Leggere e scrivere file Lakehouse; accesso in sola lettura agli endpoint SQL
• Database con mirroring - Accesso in sola lettura ai dati del database con mirroring

La scrittura posteriore nei flussi di attività translitici di Power BI è supportata in modo nativo quando si richiamano le funzioni dati utente. Le funzioni dati utente possono eseguire operazioni di aggiunta, aggiornamento ed eliminazione su Fabric Database SQL, Fabric Data Warehouse e Lakehouse, rendendoli il punto di integrazione ideale per scenari di scrittura writeback 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 univoco 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 Funzioni dati utente supportano l'autenticazione microsoft Entra ID, garantendo l'accesso sicuro da sistemi esterni. Informazioni su come richiamare funzioni dati utente da un'applicazione Python.

Get started

Pronto per creare la prima funzione 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 su Python SDK, decorator e funzionalità avanzate
• Richiamare le funzioni da un'applicazione Python : informazioni su come chiamare le funzioni tramite endpoint REST da sistemi esterni