Creare un elemento di funzioni dati utente di Fabric

In questa guida verrà creato un nuovo elemento delle funzioni per i dati utente e verranno scritte nuove funzioni al suo interno. Ogni elemento delle funzioni per i dati utente contiene codice che definisce una o più funzioni che è possibile eseguire singolarmente.

In particolare, si apprenderà come:

• Creare un elemento delle funzioni per i dati utente.
• Scrivere una nuova funzione.
• Gestire le funzioni.
• Esegui la tua funzione.

Prerequisiti

• Capacità di Microsoft Fabric in una delle aree supportate. Se non si dispone di una capacità Fabric, è possibile creare una capacità di valutazione gratuita.
• Un’area di lavoro Fabric collegata a tale capacità

Creare un nuovo elemento delle funzioni per i dati utente di Fabric

1. Selezionare l'area di lavoro e selezionare + Nuovo elemento.
2. Selezionare Tutti gli elementi come tipo di elemento. Cercare e selezionare Funzioni per i dati utente.

Creare un nuovo elemento per le funzioni per i dati utente

1. Nell'area di lavoro selezionare + Nuovo elemento.

2. Nel riquadro visualizzato cercare user data functions e quindi selezionare il riquadro.

   

3. Specificare un nome per l'elemento delle funzioni per i dati utente.

4. Selezionare Nuova funzione per creare un modello di funzione Python hello_fabric. Esplora funzioni mostra tutte le funzioni pubblicate e pronte per essere richiamate.

   

5. Dopo aver pubblicato la funzione hello_fabric, è possibile eseguirla dall'elenco di funzioni in Esplora funzioni.

   

Aggiungere una nuova funzione dal campione

Questo è un esempio di come aggiungere una nuova funzione dal menu Insert sample. In questo caso, verrà aggiunta una funzione denominata Modificare i dati con la libreria Pandas che utilizza la libreria pandas come requisito. Seguire la procedura per aggiungere questa funzione di esempio:

1. Assicurarsi di essere in modalità Sviluppo. Selezionare Gestione librerie per aggiungere le librerie richieste dalla funzione.

   

   Nota

   La libreria fabric_user_data_functions viene aggiunta per impostazione predefinita e non può essere rimossa. Questa libreria è necessaria per la funzionalità delle funzioni per i dati utente. È necessario aggiornare la versione di questa libreria per tutte le versioni future dell’SDK.

2. Selezionare la libreria Pandas e quindi selezionare la versione. Dopo l’aggiunta della libreria, questa viene salvata automaticamente nell'elemento delle funzioni per i dati utente.

   

3. Selezionare Inserisci esempio e quindi selezionare Modifica dati con la libreria Pandas. Questa azione inserirà codice di esempio nella parte inferiore del codice, dopo le altre funzioni.

   

4. Dopo aver inserito l'esempio nell'editor, testarlo usando la funzionalità Test in modalità Sviluppo.

5. Quando si è pronti, è possibile selezionare Pubblica per salvare le modifiche e aggiornare le funzioni. La pubblicazione potrebbe richiedere alcuni minuti.

   

6. Al termine della pubblicazione, la nuova funzione verrà visualizzata nell'elenco Esplora funzioni. Questa funzione è ora pronta per l'esecuzione dal portale o richiamata da un'altra applicazione o da un altro elemento di Fabric, ad esempio una pipeline.

   

Esegui la tua funzione

1. Per eseguire la funzione, è prima necessario passare alla modalità Esegui solo facendo clic sull'interruttore modalità.

   

2. Selezionare l’icona Esegui che viene visualizzata quando si passa il puntatore del mouse su una funzione nell'elenco Esplora funzioni.

   

3. Passare i parametri obbligatori presentati come modulo in Esplora funzioni. In questo caso, verrà eseguita la funzione manipulate_data che richiede una stringa JSON come parametro.

   [
    {
     "Name": "John",
     "Age": 22,
     "Gender": "male"
    }
   ]
   

4. Selezionare Esegui per eseguire la funzione.

   

5. È possibile visualizzare i log in tempo reale e l'output per la funzione per verificare se è stata eseguita correttamente. In alternativa, verrà visualizzato un messaggio di errore e i log dalla chiamata della funzione.

Scrivere una nuova funzione

Ogni funzione eseguibile inizia con un elemento Decorator @udf.function() che precede la definizione della funzione. Altre informazioni sul modello di programmazione Python. Per scrivere una nuova funzione, usare l’elemento Decorator @udf.function() all'inizio per dichiararla come funzione eseguibile. Di seguito è riportato un esempio di funzione:

# This sample allows you to pass a credit card number as an integer and mask it, leaving the last 4 digits. 

@udf.function()
def maskCreditCard(cardNumber: int)-> str:
    # Convert the card number to a string
    cardNumberStr = str(cardNumber)
    
    # Check if the card number is valid
    if not cardNumberStr.isdigit() or not (13 <= len(cardNumberStr) <= 19):
        raise ValueError("Invalid credit card number")
    
    # Mask all but the last four digits
    maskedNumber = '*' * (len(cardNumberStr) - 4) + cardNumberStr[-4:]
    
    return str(maskedNumber)

Quando la funzione è pronta, pubblicarla per eseguirla.

Concetti chiave del modello di programmazione

Le funzioni per i dati utente utilizzano il modello di programmazione Python per le funzioni per i dati utente per creare, eseguire, eseguire il debug e modificare le singole funzioni. Si tratta di una libreria proprietaria che fornisce la funzionalità necessaria per richiamare le funzioni in Fabric e sfruttare tutte le integrazioni.

Dopo aver creato la prima funzione, le prime righe del codice conterranno le istruzioni di importazione con le librerie necessarie per eseguire il modello.

import datetime
import fabric.functions as fn
import logging

udf = fn.UserDataFunctions()

Nota

Le istruzioni di importazione contenenti la fabric.functionslibreria e la riga contenente tale istruzioneudf = fn.UserDataFunctions() sono necessarie per eseguire correttamente le funzioni. Le funzioni non funzioneranno correttamente se queste righe non sono presenti.

• Per creare, eseguire e gestire le funzioni, è necessario fabric.functions SDK e poche altre importanti librerie, ad esempio logging consente di scrivere log personalizzati.
• udf=fn.UserDataFunctions() è il costrutto per definire funzioni all'interno di un elemento delle funzioni per i dati utente.

Gestire le funzioni per i dati

Rinominare una funzione

1. In Modalità sviluppo selezionare nell'editor di codice e aggiornare il nome della funzione. Ad esempio, rinominare hello_fabrichello_fabric1in :

   @udf.function()
   def hello_fabric1(name: str) -> str:
      logging.info('Python UDF trigger function processed a request.')
   
      return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"
   

2. Dopo aver modificato il nome, selezionare Pubblica per salvare le modifiche.

3. Dopo la pubblicazione delle modifiche, è possibile visualizzare il nuovo nome della funzione in Esplora funzioni.

Eliminare una funzione

Per eliminare una funzione, selezionare il codice della funzione nell'editor di codice e rimuovere l'intera sezione del codice. Pubblicare le modifiche per eliminarle interamente dall'elemento delle funzioni per i dati utente.

Ad esempio, per eliminare la funzione hello_fabric, rimuovere il blocco di codice seguente:

@udf.function()
def hello_fabric(name: str) -> str:
    logging.info('Python UDF trigger function processed a request.')

    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

Dopo aver rimosso il codice, è possibile selezionare Pubblica per salvare le modifiche. Al termine della pubblicazione, viene visualizzato un elenco aggiornato delle funzioni disponibili in Esplora funzioni.

Passaggi successivi

• Creare un elemento delle funzioni per i dati utente in Visual Studio Code
• Altre informazioni sul modello di programmazione delle funzioni per i dati utente