Condividi tramite

Funzioni di espressione 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 espressione supportate da Azure Data Factory e Azure Synapse Analytics nei flussi di dati di mapping.

Elenco di funzioni di espressione

Nelle pipeline di Data Factory e Synapse usare il linguaggio delle espressioni della funzionalità flusso di dati di mapping per configurare le trasformazioni dei dati.

Funzione expression Attività
abs Valore assoluto di un numero.
acos Calcola il valore della funzione inversa del coseno.
add Aggiunge una coppia di stringhe o numeri. Aggiunge una data a un numero di giorni. Aggiunge una durata a un timestamp. Aggiunge una matrice di tipo simile a un'altra. Uguale all'operatore +.
e Operatore AND logico. Uguale a &&.
asin Calcola il valore della funzione inversa del seno.
assertErrorMessages Restituisce la mappa di tutti i messaggi assert.
atan Calcola il valore della tangente inversa.
atan2 Restituisce l'angolo in radianti, tra l'asse x positivo di un piano e il punto specificato dalle coordinate.
tra Controlla se il primo valore è compreso tra altri due valori in modo inclusivo. È possibile confrontare valori numerici, stringa e datetime
bitwiseAnd Operatore bitwise AND bit a bit tra tipi integrali. Uguale all'operatore & .
bitwiseOr Operatore bitwise OR bit a bit tra tipi integrali. Uguale a | operatore.
bitwiseXor Operatore bitwise OR bit a bit tra tipi integrali. Uguale a | operatore.
blake2b Calcola il digest Blake2 del set di colonne di tipi di dati primitivi variabili in base a una lunghezza di bit. La lunghezza del bit può essere costituita solo da più di 8 tra 8 e 512. Può essere usato per calcolare un'impronta digitale per una riga.
blake2bBinary Calcola il digest Blake2 di un set di colonne di diversi tipi di dati primitivi, data una lunghezza in bit che può corrispondere solo a valori multipli di 8 compresi tra 8 e 512. Può essere usato per calcolare un'impronta digitale per una riga
case In base alle condizioni alternative, applica un valore o l'altro. Se il numero di input è pari, l'altro valore è NULL per impostazione predefinita in base all'ultima condizione.
cbrt Calcola la radice cubica di un numero.
ceil Restituisce l’intero più piccolo non inferiore al numero.
coalesce Restituisce il primo valore diverso da NULL da un set di input. Tutti gli input devono essere dello stesso tipo.
columnNames Ottiene i nomi di tutte le colonne di output per un flusso. È possibile passare un nome di flusso facoltativo come primo argomento e un secondo argomento facoltativo per restituire solo colonne di deriva dello schema.
columns Ottiene i valori di tutte le colonne di output per un flusso. È possibile passare un nome di flusso facoltativo come secondo argomento.
compare Confronta due valori dello stesso tipo. Restituisce un numero intero negativo se value1 < value2, 0 se value1 == value2, valore positivo se value1 > value2.
concat Concatena un numero variabile di stringhe. Uguale all'operatore + con le stringhe.
concatWS Concatena un numero variabile di stringhe con un separatore. Il primo parametro è il separatore.
cos Calcola il valore del coseno.
cosh Calcola il coseno iperbolico di un valore.
crc32 Calcola l'hash CRC32 del set di colonne di tipi di dati primitivi variabili in base a una lunghezza di bit. La lunghezza del bit deve essere di valori 0 (256), 224, 256, 384 o 512. Può essere usato per calcolare un'impronta digitale per una riga.
Gradi Converte i radianti in gradi.
dividere Divide coppie di numeri. Uguale all'operatore /.
dropLeft Rimuove lo stesso numero di caratteri dalla parte sinistra della stringa. Se l'eliminazione richiesta supera la lunghezza della stringa, viene restituita una stringa vuota.
dropRight Rimuove lo stesso numero di caratteri dalla parte destra della stringa. Se l'eliminazione richiesta supera la lunghezza della stringa, viene restituita una stringa vuota.
endsWith Controlla se la stringa termina con la stringa specificata.
equals Operatore equals di confronto. Uguale all'operatore ==.
equalsIgnoreCase Operatore equals di confronto, ignorando la distinzione tra maiuscole e minuscole. Uguale all'operatore <=>.
escape Esegue l'escape di una stringa in base a un formato. I valori letterali per il formato accettabili sono ''json'', ''xml'', ''ecmascript'', ''html'' e ''java''.
expr Restituisce un'espressione da una stringa. Equivale a scrivere l'espressione in un formato non letterale e può essere usata per passare i parametri come rappresentazioni di stringa.
fattoriale Calcola il fattoriale di un numero.
false Restituisce sempre un valore false. Usare la funzione syntax(false()) se è presente una colonna denominata ''false''.
floor Restituisce l'intero più grande non superiore al numero.
fromBase64 Decodifica la stringa codificata in base64 specificata.
greater Operatore greater di confronto. Uguale all'operatore >.
greaterOrEqual Operatore greater than o equal di confronto. Uguale all'operatore >=.
maggiore Restituisce il valore più grande dell'elenco di valori come input ignorando i valori NULL. Restituisce Null se tutti gli input sono Null.
hasColumn Verifica la presenza di un valore di colonna nel flusso in base al nome. È possibile passare un nome di flusso facoltativo come secondo argomento. I nomi di colonna noti in fase di progettazione devono essere riportati solo in base al relativo nome. Gli input calcolati non sono supportati, ma è possibile usare le sostituzioni di parametro.
hasError Controlla se l'asserzione con ID specificato è contrassegnata come errore.
iif In base alla condizione specifica, applica un valore o l'altro. Se l'altro non è specificato, viene considerato NULL. Entrambi i valori devono essere compatibili (numeric, string...).
iifNull Dati due o più input, restituisce il primo elemento non NULL. Questa funzione equivale a unire.
initCap Converte la prima lettera di ogni parola in lettere maiuscole. Le parole vengono identificate come separate in base agli spazi vuoti.
Instr Trova la posizione (in base 1) della sottostringa all'interno di una stringa. Se non trovata, restituisce 0.
isDelete Controlla se la riga è contrassegnata per l'eliminazione. Per le trasformazioni che accettano più di un flusso di input è possibile fornire l'indice del flusso (in base 1). L'indice del flusso deve essere 1 o 2 e il valore predefinito è 1.
isError Controlla se la riga è contrassegnata come errore. Per le trasformazioni che accettano più di un flusso di input è possibile fornire l'indice del flusso (in base 1). L'indice del flusso deve essere 1 o 2 e il valore predefinito è 1.
isIgnore Controlla se la riga è contrassegnata per essere ignorata. Per le trasformazioni che accettano più di un flusso di input è possibile fornire l'indice del flusso (in base 1). L'indice del flusso deve essere 1 o 2 e il valore predefinito è 1.
isInsert Controlla se la riga è contrassegnata per l'inserimento. Per le trasformazioni che accettano più di un flusso di input è possibile fornire l'indice del flusso (in base 1). L'indice del flusso deve essere 1 o 2 e il valore predefinito è 1.
isMatch Controlla se per la riga viene trovata una corrispondenza. Per le trasformazioni che accettano più di un flusso di input è possibile fornire l'indice del flusso (in base 1). L'indice del flusso deve essere 1 o 2 e il valore predefinito è 1.
isNull Controlla se il valore è NULL.
isUpdate Controlla se la riga è contrassegnata per l'aggiornamento. Per le trasformazioni che accettano più di un flusso di input è possibile fornire l'indice del flusso (in base 1). L'indice del flusso deve essere 1 o 2 e il valore predefinito è 1.
isUpsert Controlla se la riga è contrassegnata per l'inserimento. Per le trasformazioni che accettano più di un flusso di input è possibile fornire l'indice del flusso (in base 1). L'indice del flusso deve essere 1 o 2 e il valore predefinito è 1.
jaroWinkler Ottiene la distanza JaroWinkler tra due stringhe.
minimo Operatore lesser than o equal di confronto. Uguale all'operatore <=.
left Estrae una sottostringa iniziale in corrispondenza dell'indice 1 con il numero di caratteri specificato. Uguale a SUBSTRING(str, 1, n).
length Restituisce la lunghezza della stringa.
minore Operatore less di confronto. Uguale all'operatore <.
minorOrEqual Operatore lesser than o equal di confronto. Uguale all'operatore <=.
levenshtein Ottiene la distanza di Levenshtein tra due stringhe.
like Il modello è una stringa con corrispondenza letterale. Le eccezioni sono i seguenti simboli speciali: _ corrisponde a qualsiasi carattere nell'input (simile a. nelle posix espressioni regolari)
situare Trova la posizione (in base 1) della sottostringa all'interno di una stringa a partire da una determinata posizione. Se la posizione viene omessa, è considerata dall'inizio della stringa. Se non trovata, restituisce 0.
log Calcola il valore del logaritmo. È possibile specificare una base facoltativa se viene usato un numero di Eulero.
log10 Calcola il valore del logaritmo in base 10.
abbassare Applica il formato minuscolo a tutti i caratteri di una stringa.
lpad Riempie a sinistra la stringa in base al riempimento specificato fino a raggiungere una determinata lunghezza. Se la stringa è uguale o superiore alla lunghezza, viene troncata alla lunghezza.
ltrim Rimuove i caratteri iniziali dal lato sinistro di una stringa. Se il secondo parametro non è specificato, rimuove lo spazio vuoto. In caso contrario, rimuove qualsiasi carattere specificato nel secondo parametro.
md5 Calcola il digest MD5 di un set di colonne di diversi tipi di dati primitivi e restituisce una stringa esadecimale a 32 caratteri. Può essere usato per calcolare un'impronta digitale per una riga.
minus Sottrae numeri. Sottrarre il numero di giorni da una data. Sottrarre la durata da un timestamp. Sottrarre due timestamp per ottenere la differenza in millisecondi. Uguale all'operatore -.
mod Calcola il modulo di coppie di numeri. Uguale all'operatore operatore %.
moltiplicare Moltiplica coppie di numeri. Uguale all'operatore *.
negate Nega un numero. Trasforma i numeri positivi in negativi e viceversa.
nextSequence Restituisce la sequenza univoca successiva. Il numero è consecutivo solo all'interno di una partizione ed è preceduto da partitionId.
normalizzare Normalizza il valore della stringa per separare i caratteri Unicode accentati.
not Operatore di negazione logico.
notEquals Operatore not equals di confronto. Uguale all'operatore !=.
Null Restituisce un valore NULL. Usare la funzione syntax(null()) se è presente una colonna denominata ''null''. Qualsiasi operazione usata restituirà un valore NULL.
or Operatore OR logico. Ugual a ||.
pMod Calcola il modulo positivo di coppie di numeri.
partitionId Restituisce l'ID di partizione corrente in cui si trova la riga di input.
power Eleva un numero alla potenza di un altro.
Radianti Converte i gradi in radianti
random Restituisce un numero casuale dato un valore di inizializzazione facoltativo all'interno di una partizione. Il valore di inizializzazione deve essere un valore fisso e viene usato con partitionId per produrre valori casuali
regexExtract Estrae una sottostringa corrispondente per un modello di espressione regolare specificato. L'ultimo parametro identifica il gruppo di corrispondenza e, se omesso, viene usato il valore predefinito 1. Usare `<regex>` (virgolette indietro) per trovare una corrispondenza con una stringa senza escape.
regexMatch Verifica se la stringa corrisponde al modello di espressione regolare specificato. Usare `<regex>` (virgolette indietro) per trovare una corrispondenza con una stringa senza escape.
regexReplace Sostituire tutte le occorrenze di un criterio regex con un'altra sottostringa nella stringa specificata Usare `<regex>` (virgolette indietro) per trovare una corrispondenza con una stringa senza escape.
regexSplit Suddivide una stringa in base a un delimitatore basato su un'espressione regolare e restituisce una matrice di stringhe.
replace Sostituisce tutte le occorrenze di una sottostringa con un'altra sottostringa nella stringa specificata. Se l'ultimo parametro viene omesso, il valore predefinito è una stringa vuota.
ordinamento inverso Inverte una stringa.
right Estrae una sottostringa finale con il numero di caratteri specificato. Uguale all'operatore SUBSTRING(str, LENGTH(str) - n, n).
rlike Verifica se la stringa corrisponde al modello di espressione regolare specificato.
round Arrotonda un numero in base a una scala e a una modalità di arrotondamento facoltative. Se la scala viene omessa, viene usato il valore predefinito 0. Se la modalità di arrotondamento viene omessa, viene usato il valore predefinito ROUND_HALF_UP(5). I valori per l'arrotondamento includono
rpad Riempie a destra la stringa in base al riempimento specificato fino a raggiungere una determinata lunghezza. Se la stringa è uguale o superiore alla lunghezza, viene troncata in base a tale lunghezza.
rtrim Rimuove i caratteri finali dal lato destro di una stringa. Se il secondo parametro non è specificato, rimuove lo spazio vuoto. In caso contrario, rimuove qualsiasi carattere specificato nel secondo parametro.
sha1 Calcola il digest SHA-1 di un set di colonne di diversi tipi di dati primitivi e restituisce una stringa esadecimale a 40 caratteri. Può essere usato per calcolare un'impronta digitale per una riga.
sha2 Calcola il digest SHA-2 di un set di colonne di diversi tipi di dati primitivi, data una lunghezza in bit che può avere solo i valori 0(256), 224, 256, 384 e 512. Può essere usato per calcolare un'impronta digitale per una riga.
sin Calcola il valore del seno.
sinh Calcola il valore del seno iperbolico.
soundex Ottiene il codice soundex per la stringa.
split Suddivide una stringa in base a un delimitatore e restituisce una matrice di stringhe.
sqrt Calcola la radice quadrata di un numero.
startsWith Controlla se la stringa inizia con la stringa specificata.
substring Estrae una sottostringa di una determinata lunghezza da una posizione. La posizione è in base 1. Se la lunghezza viene omessa, per impostazione predefinita viene estratta la parte finale della stringa.
substringIndex Estrae la sottostringa prima del count delle occorrenze del delimitatore. Se count è positivo, viene restituito tutto ciò che si trova a sinistra del delimitatore finale (conteggio da sinistra). Se count è negativo, viene restituito tutto ciò che si trova a destra del delimitatore finale (conteggio da destra).
tan Calcola il valore della tangente.
tanh Calcola il valore della tangente iperbolica.
Traduci Sostituisce un set di caratteri con un altro set di caratteri nella stringa. Viene eseguita una sostituzione da 1 a 1.
Trim Rimuove i caratteri iniziali e finali di una stringa. Se il secondo parametro non è specificato, rimuove lo spazio vuoto. In caso contrario, rimuove qualsiasi carattere specificato nel secondo parametro.
true Restituisce sempre un valore true. Usare la funzione syntax(true()) se è presente una colonna denominata ''true''.
typeMatch Trova corrispondenze tra tipi di colonne. Può essere usato solo nelle espressioni pattern.number corrisponde a short, integer, long, double, float o decimal, integral match short, integer, long, fractional match double, float, decimal e datetime corrisponde al tipo date o timestamp.
unescape Annulla l'escape di una stringa in base a un formato. I valori letterali per il formato accettabili sono ''json'', ''xml'', ''ecmascript'', ''html'' e ''java''.
superiore Applica il formato maiuscolo a tutti i caratteri di una stringa.
uuid Restituisce l'UUID generato.
xor Operatore XOR logico. Uguale all'operatore ^.

Contenuto correlato