Condividi tramite


Funzioni di matrice 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 completa 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 Azure Synapse Pipelines. Questo articolo si applica ai flussi di dati di mapping. Se non si ha esperienza con le trasformazioni, vedere l'articolo introduttivo Trasformare i dati usando un flusso di dati di 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 di un indice di matrice. L'indice è basato su 1. L'indice out-of-bounds 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 distinto di elementi di 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. Accetta una funzione di filtro in cui è possibile indirizzare l'elemento nella matrice come #item. Per le mappe annidate in modo approfondito, è possibile fare riferimento alla notazione #item_n(#item_1, #item_2...).
flatten Rende flat la matrice o le matrici in una singola matrice. Le matrici di elementi atomici vengono restituite invariate. L'ultimo argomento è facoltativo ed è impostato su false per rendere flat in modo ricorsivo più di un livello profondo.
in Controlla se un elemento si trova nella matrice.
Intersect 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. Map prevede un riferimento a un elemento nella funzione di espressione come #item.
mapIf Esegue il mapping condizionale di una matrice a un'altra matrice di lunghezza uguale o inferiore. I valori possono essere di qualsiasi tipo di dati, inclusi 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 padre usando la #item_[n](#item_1, #index_1...) notazione .
mapIndex Esegue il mapping di ogni elemento della matrice a un nuovo elemento usando l'espressione fornita. Map prevede un riferimento a un elemento nella funzione di espressione come #item e un riferimento all'indice dell'elemento come #index.
mapLoop Esegue un ciclo da 1 a 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 alla notazione #index_n(#index_1, #index_2...) padre.
Ridurre Accumula gli elementi in una matrice. Reduce prevede un riferimento a un enumeratore e un elemento nella prima funzione di espressione come #acc e #item e prevede che il valore risultante venga usato come #result nella seconda funzione di 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 di espressione come #item1 e #item2.
Spiegare Apre 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.