Condividi tramite


Funzioni di matrice nei flussi 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 per mapping. Se non si ha familiarità con le trasformazioni, vedere l'articolo introduttivo Trasformare i dati usando flussi di dati di mapping.

Questo articolo fornisce 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. Le parole chiave speciali indirizzano gli elementi e gli indici della matrice:

  • #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 dell'indice di 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 è basato su 1. L'indice fuori dai limiti restituisce un valore nullo. Trova un valore in una mappa quando viene specificata una chiave. Se la chiave non viene trovata, restituisce Null.
contains Restituisce true se un elemento nella matrice fornita restituisce true nel predicato fornito. La contains funzione 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 gli elementi dalla matrice che non soddisfano il predicato specificato. La filter funzione prevede un riferimento a un elemento nella funzione predicato come #item.
find Trova il primo elemento da una matrice che corrisponde alla condizione. Accetta una filter funzione in cui è possibile indirizzare l'elemento nella matrice come #item. Per le mappe annidate in modo approfondito, è possibile fare riferimento alle mappe padre usando la #item_n(#item_1, #item_2...) notazione .
flatten Appiattisce una matrice o delle 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.
intersect Restituisce un set di intersezioni di elementi distinti da due matrici.
map Esegue il mapping di ogni elemento della matrice a un nuovo elemento usando l'espressione fornita. La map funzione prevede un riferimento a un elemento nella funzione di espressione come #item.
mapIf Mappa condizionalmente una matrice su un'altra matrice di lunghezza pari o inferiore. I valori possono essere di qualsiasi tipo di dati, incluso 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. La map funzione 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 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 padre usando la #index_n(#index_1, #index_2...) notazione .
ridurre Accumula gli elementi in una matrice. La funzione reduce prevede un riferimento a un enumeratore e un elemento nella prima funzione di espressione come #acc e #item. Si prevede che il valore #result risultante venga usato 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.
sort Ordina la matrice usando la funzione predicato fornita. La sort funzione prevede un riferimento a due elementi consecutivi nella funzione di espressione come #item1 e #item2.
unfold 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 due matrici.

Altre funzioni disponibili