Funzioni definite dall'utente nel flusso di dati di mapping

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi all-in-one per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come avviare gratuitamente una nuova versione di valutazione .

I flussi di dati sono disponibili sia in Azure Data Factory che in pipeline di Azure Synapse. Questo articolo si applica al mapping dei flussi di dati. Se non si ha esperienza con le trasformazioni, vedere l'articolo introduttivo Trasformare i dati usando un flusso di dati di mapping.

Una funzione definita dall'utente è un'espressione personalizzata che è possibile definire per poter riutilizzare la logica tra più flussi di dati di mapping. Le funzioni definite dall'utente si trovano in una raccolta denominata libreria del flusso di dati per poter raggruppare facilmente set comuni di funzioni personalizzate.

Ogni volta che ci si trova a creare la stessa logica in un'espressione in più flussi di dati di mapping, questa sarebbe una buona opportunità per trasformarla in una funzione definita dall'utente.

Introduzione

Per iniziare a usare le funzioni definite dall'utente, è prima necessario creare una libreria del flusso di dati. Passare alla pagina di gestione e quindi trovare le librerie del flusso di dati nella sezione dell'autore.

Libreria del flusso di dati

Da qui è possibile fare clic sul pulsante +Nuovo per creare una nuova libreria del flusso di dati. Compilare il nome e la descrizione e quindi si è pronti per creare la funzione definita dall'utente.

Nuova funzione definita dall'utente

Per creare una funzione definita dall'utente, dalla libreria del flusso di dati in cui si vuole creare la funzione, fare clic sul pulsante +Nuovo.

Immettere il nome della funzione definita dall'utente.

Nota

Non è possibile usare il nome di un'espressione del flusso di dati di mapping esistente. Per un elenco delle espressioni del flusso di dati di mapping correnti, vedere Espressioni di trasformazione dei dati nel flusso di dati di mapping | Microsoft Docs

Le funzioni definite dall'utente possono avere zero o più argomenti. Gli argomenti consentono di passare valori quando la funzione viene chiamata e fare riferimento a tali argomenti nella logica dell'espressione. Gli argomenti vengono denominati automaticamente da i1, i2 e così via. ed è possibile scegliere il tipo di dati dell'argomento dall'elenco a discesa.

Il corpo della funzione definita dall'utente è la posizione in cui si specifica la logica della funzione. L'editor fornisce il generatore di espressioni completo | Microsoft Docs esperienza e consente di fare riferimento agli argomenti creati e alle espressioni di trasformazione dei dati nel flusso di dati di mapping | Microsoft Docs.

Nota

Una funzione definita dall'utente non può fare riferimento a un'altra funzione definita dall'utente.

Uso di una funzione definita dall'utente nel generatore di espressioni

Le funzioni definite dall'utente verranno visualizzate nel generatore di espressioni del flusso di dati di mapping in Funzioni della libreria del flusso di dati. Da qui è possibile usare le funzioni create personalizzate e passare argomenti appropriati (se presenti) definiti.