Condividi tramite

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

Elenco di funzioni per le espressioni

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

Funzione espressione Attività
abs Assegna il 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 +.
and Usa l'operatore logico AND . Uguale a &&.
asin Calcola il valore della funzione inversa del seno.
assertErrorMessages Restituisce una 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.
between Controlla se il primo valore è compreso tra altri due valori in modo inclusivo. È possibile confrontare valori numerici, stringa e datetime valori.
bitwiseAnd Utilizza l'operatore bitwise And su tipi integrali. Uguale all'operatore &.
bitwiseOr Utilizza l'operatore bitwise Or su tipi integrali. Uguale all'operatore |.
bitwiseXor Utilizza l'operatore bitwise Or su tipi integrali. Uguale all'operatore |.
blake2b Calcola il digest Blake2 di un set di colonne di tipi di dati primitivi diversi quando viene specificata una lunghezza di bit. La lunghezza in bit può essere solo un multiplo di 8 compreso tra 8 e 512. È possibile usarlo per calcolare un'impronta digitale per una riga.
blake2bBinary Calcola il digest Blake2 di un set di colonne di tipi di dati primitivi variabili quando viene data una lunghezza di bit, che può essere costituita solo da multipli di 8 tra 8 e 512. È possibile usarlo per calcolare un'impronta digitale per una riga.
case Applica un valore o l'altro in base a condizioni alternate. Se il numero di input è pari, l'altro viene impostato su NULL come valore predefinito per l'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 o 0 se value1 == value2 e restituisce un valore positivo se value1 > value2.
concat Concatena un numero variabile di stringhe. Uguale all'operatore + con 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 di un set di colonne di tipi di dati primitivi variabili quando viene specificata una lunghezza di bit. La lunghezza del bit deve essere di valori 0 (256), 224, 256, 384e 512. È possibile usarlo per calcolare un'impronta digitale per una riga.
degrees Converte i radianti in gradi.
divide Divide una coppia di numeri. Uguale all'operatore /.
dropLeft Rimuove il numero di caratteri specificato a sinistra della stringa. Se l'eliminazione richiesta supera la lunghezza della stringa, viene restituita una stringa vuota.
dropRight Rimuove il numero di caratteri specificato a 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 Usa l'operatore equals di confronto. Uguale all'operatore ==.
equalsIgnoreCase Usa l'operatore equals di confronto e ignora 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 accettabile sono json, xml, ecmascript, htmle java.
expr Restituisce un'espressione da una stringa. Equivale a scrivere l'espressione in un formato nonliterale. È possibile usarlo per passare i parametri come rappresentazioni di stringa.
factorial 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 con codifica base64 specifica.
greater Usa l'operatore di confronto maggiore di . Uguale all'operatore >.
greaterOrEqual Usa l'operatore greater than o equal to di confronto. Uguale all'operatore >=.
greatest 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 riferiti usando solo il nome. Gli input calcolati non sono supportati, ma è possibile usare le sostituzioni dei parametri.
hasError Controlla se l'asserzione con l'ID specificato è contrassegnata come errore.
iif Applica un valore o l'altro in base a una condizione. Se l'altro non è specificato, il valore viene considerato NULL. Entrambi i valori devono essere compatibili (ad esempio, numerico o stringa).
iifNull Restituisce il primo elemento non Null quando vengono specificati due o più input. ed equivale a coalesce.
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 (1 in base) della sottostringa all'interno di una stringa. Se non viene trovato, 0 viene restituito .
isDelete Controlla se la riga è contrassegnata per l'eliminazione. Per le trasformazioni che accettano più flussi di input, è possibile passare l'indice (basato su 1) del flusso. L'indice del flusso deve essere 1 o 2e il valore predefinito è 1.
isError Controlla se la riga è contrassegnata come errore. Per le trasformazioni che accettano più flussi di input, è possibile passare l'indice (basato su 1) del flusso. L'indice del flusso deve essere 1 o 2. Il valore predefinito è 1.
isIgnore Controlla se la riga deve essere ignorata. Per le trasformazioni che accettano più flussi di input, è possibile passare l'indice (basato su 1) del flusso. L'indice del flusso deve essere 1 o 2. Il valore predefinito è 1.
isInsert Controlla se la riga è contrassegnata per l'inserimento. Per le trasformazioni che accettano più flussi di input, è possibile passare l'indice (basato su 1) del flusso. L'indice del flusso deve essere 1 o 2. Il valore predefinito è 1.
isMatch Controlla se per la riga viene trovata una corrispondenza. Per le trasformazioni che accettano più flussi di input, è possibile passare l'indice (basato su 1) del flusso. L'indice del flusso deve essere 1 o 2. 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ù flussi di input, è possibile passare l'indice (basato su 1) del flusso. L'indice del flusso deve essere 1 o 2. Il valore predefinito è 1.
isUpsert Controlla se la riga è contrassegnata per l'inserimento. Per le trasformazioni che accettano più flussi di input, è possibile passare l'indice (basato su 1) del flusso. L'indice del flusso deve essere 1 o 2. Il valore predefinito è 1.
jaroWinkler Ottiene la distanza JaroWinkler tra due stringhe.
least Usa l'operatore lesser than o equal to di confronto. Uguale all'operatore <=.
left Estrae una sottostringa che inizia in corrispondenza dell'indice 1 con il numero di caratteri. Uguale a SUBSTRING(str, 1, n).
length Restituisce la lunghezza della stringa.
lesser Usa l'operatore less di confronto. Uguale all'operatore <.
lesserOrEqual Usa l'operatore lesser than o equal to di confronto. Uguale all'operatore <=.
levenshtein Ottiene la distanza di Levenshtein tra due stringhe.
like Usa un modello con una stringa con corrispondenza letterale. L'eccezione è il simbolo _ speciale che corrisponde a un carattere nell'input (simile a .* nelle posix espressioni regolari).
locate Trova la posizione (1 in base) della sottostringa all'interno di una stringa che inizia una determinata posizione. Se la posizione viene omessa, iniziare dall'inizio della stringa. Se non viene trovato, 0 viene restituito .
log Calcola il valore del log. È possibile specificare una base facoltativa oppure un numero eulero, se usato.
log10 Calcola il valore del log in base a una base 10.
lower 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 maggiore della lunghezza, la stringa viene tagliata fino alla lunghezza.
ltrim Rimuove i caratteri iniziali dal lato sinistro di una stringa. Se il secondo parametro non è specificato, taglia gli spazi vuoti. In caso contrario, taglia qualsiasi carattere specificato nel secondo parametro.
md5 Calcola il digest MD5 di un set di colonne di tipi di dati primitivi variabili e restituisce una stringa esadecimale di 32 caratteri. È possibile usarlo per calcolare un'impronta digitale per una riga.
minus Sottrae numeri. Sottrae il numero di giorni da una data. Sottrae la durata da una marca temporale. Sottrae due timestamp per ottenere la differenza in millisecondi. Uguale all'operatore -.
mod Fornisce il modulo di una coppia di numeri. Uguale all'operatore %.
multiply Moltiplica una coppia 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 e viene preceduto dall'ID partizione.
normalize Normalizza il valore stringa in modo da separare i caratteri Unicode accentati.
not Usa l'operatore di negazione logica.
notEquals Usa l'operatore not equals di confronto. Uguale all'operatore !=.
null Restituisce un NULL valore. Usare la funzione syntax(null()) se è presente una colonna denominata null. Qualsiasi operazione che lo usa risulta in un oggetto NULL.
or Usa l'operatore logico OR . Uguale a ||.
pMod Fornisce il modulo positivo di una coppia 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.
radians Converte i gradi in radianti.
random Restituisce un numero casuale quando viene fornito un seme opzionale all'interno di una partizione. Il seme dovrebbe essere un valore fisso e viene utilizzato con l'ID della partizione per produrre valori casuali.
regexExtract Estrae una sottostringa corrispondente per un criterio regex specifico. L'ultimo parametro identifica il gruppo di corrispondenza e, se omesso, viene usato il valore predefinito 1. Usare `<regex>` per trovare una corrispondenza con una stringa senza caratteri di escape.
regexMatch Controlla se la stringa corrisponde al modello regex specifico. Usare `<regex>` per trovare una corrispondenza con una stringa senza caratteri di escape.
regexReplace Sostituisce tutte le occorrenze di un modello regex con un'altra sottostringa nella stringa specifica. Usare `<regex>` per trovare una corrispondenza con una stringa senza caratteri di 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 specifica. Se l'ultimo parametro viene omesso, per impostazione predefinita viene utilizzata una stringa vuota.
reverse Inverte una stringa.
right Estrae una sottostringa finale con il numero di caratteri specificato. Uguale a SUBSTRING(str, LENGTH(str) - n, n).
rlike Controlla se la stringa corrisponde al modello regex specifico.
round Arrotonda un numero quando viene assegnata una scala facoltativa e una modalità di arrotondamento facoltativo. Se la scala viene omessa, il valore predefinito è 0. Se la modalità viene omessa, per impostazione predefinita viene impostato su ROUND_HALF_UP(5).
rpad Riempie a destra la stringa in base al riempimento specificato fino a raggiungere una determinata lunghezza. Se la stringa è uguale o maggiore della lunghezza, la stringa viene tagliata fino alla lunghezza.
rtrim Rimuove i caratteri finali dal lato destro di una stringa. Se il secondo parametro non è specificato, taglia gli spazi vuoti. In caso contrario, taglia qualsiasi carattere specificato nel secondo parametro.
sha1 Calcola il digest SHA-1 di un set di colonne di tipi di dati primitivi variabili e restituisce una stringa esadecimale di 40 caratteri. È possibile usarlo 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 quando viene indicata una lunghezza in bit, che può essere di valori 0 (256), 224, 256, 384 e 512. È possibile usarlo 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 utilizzata la fine 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.
translate Sostituisce un set di caratteri con un altro set di caratteri nella stringa. I caratteri vengono sostituiti uno a uno.
Trim Rimuove i caratteri iniziali e finali di una stringa. Se il secondo parametro non è specificato, taglia gli spazi vuoti. In caso contrario, taglia qualsiasi carattere specificato nel secondo parametro.
true Restituisce sempre un valore true. Usare la funzione syntax(true()) se una colonna è denominata true.
typeMatch Trova corrispondenze tra tipi di colonne. Usato solo nelle espressioni di modello. Numero corrisponde a tipi di dati come short, integer, long, double, float o decimal. Integrale corrisponde a short, integer e long. Tipi frazionati corrispondono a double, float e decimal. Datetime corrisponde al tipo indicatore data o ora.
unescape Annulla l'escape di una stringa in base a un formato. I valori letterali per il formato accettabile sono json, xml, ecmascript, htmle java.
upper Applica il formato maiuscolo a tutti i caratteri di una stringa.
uuid Restituisce l'UUID generato.
xor Fornisce l'operatore logico XOR . Uguale all'operatore ^.

Contenuti correlati

  • Last updated on