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 tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!

I flussi di dati sono disponibili sia nelle pipeline di Azure Data Factory che nelle pipeline di Azure Synapse Analytics. Questo articolo si applica ai flussi di dati di mapping. Se non si ha familiarità con le trasformazioni, vedere l'articolo introduttivo Trasformare i dati usando flussi di dati di mapping.

Una funzione definita dall'utente è un'espressione personalizzata che è possibile definire per poter riutilizzare la logica in 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 potrebbe essere una buona opportunità per trasformarla in una funzione definita dall'utente.

Iniziare

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

Libreria per il 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 correnti del flusso di dati di mapping, 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 viene chiamata la funzione 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 è il percorso in cui si specifica la logica della funzione. L'editor fornisce l'esperienza completa del costruttore di espressioni | Microsoft Docs e consente di fare riferimento agli argomenti creati e a qualsiasi espressione di trasformazione dei dati nel flusso di dati di mappatura | 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 mappatura in Funzioni della libreria del flusso di dati. Da qui è possibile usare le funzioni create personalizzate e passare argomenti appropriati (se presenti) definiti.