Condividi tramite

Funzioni di matrice nel flusso di dati di mapping

  • Articolo

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 nelle pipeline sia di Azure Data Factory che di Azure Synapse. Questo articolo si applica ai flussi di dati per mapping. Se non si ha esperienza con le trasformazioni, vedere l'articolo introduttivo Trasformare i dati con un flusso di dati per mapping.

Gli articoli seguenti forniscono informazioni dettagliate sulle funzioni di matrice supportate da Azure Data Factory e Azure Synapse Analytics nei flussi di dati di mapping.

Elenco di funzioni di matrice

Le funzioni di matrice eseguono trasformazioni sulle strutture di dati che sono matrici. Queste includono parole chiave speciali per indirizzare gli elementi della matrice e gli indici:

  • #acc rappresenta un valore che si desidera includere nell'output singolo quando si riduce una matrice
  • #index rappresenta l'indice di matrice corrente, insieme ai numeri di indice della matrice #index2, #index3 ...
  • #item rappresenta il valore dell'elemento corrente nella matrice
Funzione array Attività
array Crea una matrice di elementi. Tutti gli elementi devono essere dello stesso tipo. Se non viene specificato alcun elemento, il valore predefinito è una matrice di stringhe vuota. Uguale a un operatore di creazione [].
at Trova l'elemento in corrispondenza dell’indice di matrice. L'indice è in base 1. L'indice fuori intervallo restituisce un valore Null. Trova un valore in una mappa in base a una chiave. Se la chiave non viene trovata, restituisce null.
contains Restituisce true se un elemento nella matrice fornita restituisce true nel predicato fornito. Contains prevede un riferimento a un elemento nella funzione predicato come #item.
distinct Restituisce un set di elementi distinti da una matrice.
except Restituisce un set di differenze di una matrice da un'altra eliminazione di duplicati.
filter Filtra dalla matrice gli elementi che non soddisfano il predicato specificato. Il filtro prevede un riferimento a un elemento nella funzione predicato come #item.
find Trovare il primo elemento da una matrice che corrisponde alla condizione. Richiede una funzione di filtro in cui è possibile indirizzare l'elemento nella matrice come #item. Per le mappe annidate in modo approfondito, è possibile fare riferimento alle mappe dell’elemento padre usando la notazione #item_n(#item_1, #item_2...).
flatten Appiattisce la matrice o le matrici in una singola matrice. Le matrici di elementi atomici vengono restituite invariate. L'ultimo argomento è facoltativo e, per impostazione predefinita, impostato su false, in modo da appiattire ricorsivamente più di un livello di profondità.
in Verifica la presenza di un elemento nella matrice.
intersecare Restituisce un set di intersezioni di elementi distinti da 2 matrici.
map Esegue il mapping di ogni elemento della matrice a un nuovo elemento usando l'espressione fornita. Il mapping prevede un riferimento a un elemento nella funzione dell'espressione come #item.
mapIf Esegue il mapping di una matrice a un'altra matrice di lunghezza uguale o inferiore in modo condizionale. I valori possono provenire da qualsiasi tipo di dato, inclusi gli structTypes. Accetta una funzione di mapping in cui è possibile indirizzare l'elemento nella matrice come #item e l'indice corrente come #index. Per le mappe annidate in modo approfondito, è possibile fare riferimento alle mappe dell’elemento padre usando la notazione #item_[n](#item_1, #index_1...).
mapIndex Esegue il mapping di ogni elemento della matrice a un nuovo elemento usando l'espressione fornita. Il mapping prevede un riferimento a un elemento nella funzione dell'espressione come #item e un riferimento all'indice dell'elemento come #index.
mapLoop Esegue un ciclo da 1 alla lunghezza per creare una matrice di tale lunghezza. Accetta una funzione di mapping in cui è possibile indirizzare l'indice nella matrice come #index. Per le mappe annidate in modo approfondito, è possibile fare riferimento alle mappe dell’elemento padre usando la notazione #index_n(#index_1, #index_2...).
ridurre Accumula gli elementi in una matrice. La funzione di riduzione prevede un riferimento a un accumulatore e un elemento nella prima funzione di espressione come #acc e #item e prevede che il valore risultante sia #result da usare nella seconda funzione dell'espressione.
size Trova le dimensioni di una matrice o di un tipo di mappa
slice Estrae un subset di una matrice da una posizione. La posizione è in base 1. Se la lunghezza viene omessa, per impostazione predefinita viene utilizzata la fine della stringa.
ordinamento Ordina la matrice usando la funzione di predicato fornita. Sort prevede un riferimento a due elementi consecutivi nella funzione dell'espressione come #item1 e #item2.
spiegare Espande una matrice in un set di righe e ripete i valori per le colonne rimanenti in ogni riga.
union Restituisce un set di unioni di elementi distinti da 2 matrici.

Contenuto correlato