Partilhar via


Funções de expressão no mapeamento de fluxos de dados

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!

Os fluxos de dados estão disponíveis nos pipelines do Azure Data Factory e no Azure Synapse Analytics. Este artigo aplica-se ao mapeamento de fluxos de dados. Se você é novo em transformações, consulte o artigo introdutório Transformar dados usando fluxos de dados de mapeamento.

Este artigo fornece detalhes sobre funções de expressão suportadas pelo Azure Data Factory e Azure Synapse Analytics no mapeamento de fluxos de dados.

Lista de funções de expressão

Nos pipelines do Azure Data Factory e do Azure Synapse Analytics, utilize a linguagem de expressões da funcionalidade de fluxo de dados de mapeamento para configurar transformações de dados.

Função de expressão Task
ABS Dá o valor absoluto de um número.
ACOS Calcula um valor inverso de cosseno.
adicionar Adiciona um par de cadeias de caracteres ou números. Adiciona uma data a vários dias. Adiciona uma duração ao carimbo temporal. Acrescenta uma matriz de tipo semelhante a outra. O mesmo que o + operador.
and Usa o operador lógico AND . O mesmo que &&.
Asin Calcula um valor seno inverso.
assertErrorMessages Retorna um mapa de todas as mensagens de afirmação.
Atan Calcula um valor tangente inverso.
Atan2 Devolve o ângulo em radianos entre o eixo x positivo de um plano e o ponto dado pelas coordenadas.
entre Verifica se o primeiro valor está entre dois outros valores, inclusive. Podes comparar números, cadeias e datetime valores.
bitwiseE Utiliza o operador bitwise And entre tipos integrais. O mesmo que o & operador.
bitwiseOu Utiliza o operador bit a bit Or entre os tipos integrais. O mesmo que o | operador.
bitwiseXor Utiliza o operador bit a Or bit entre os tipos de integrais. O mesmo que o | operador.
Blake2B Calcula o resumo Blake2 de um conjunto de colunas com diferentes tipos de dados primitivos quando dado um comprimento de bit. O comprimento de bit só pode ser múltiplos de 8 entre 8 e 512. Podes usá-lo para calcular uma impressão digital para uma linha.
blake2bbinário Calcula o resumo Blake2 de um conjunto de colunas com tipos de dados primitivos variados quando é dado um comprimento de bits, que só pode ser múltiplos de 8, variando de 8 a 512. Podes usá-lo para calcular uma impressão digital para uma linha.
caixa Aplica um valor ou outro com base em condições alternadas. Se o número de entradas for par, a outra entrada é definida como NULL por defeito para a última condição.
CBRT Calcula a raiz do cubo de um número.
ceil Devolve o menor número inteiro não inferior ao número.
coalesce Retorna o primeiro valor não nulo de um conjunto de entradas. Todas as entradas devem ser do mesmo tipo.
columnNames Obtém os nomes de todas as colunas de saída de um fluxo. Pode passar um nome opcional do fluxo como primeiro argumento e um segundo argumento opcional para devolver apenas as colunas de deriva do esquema.
colunas Obtém os valores de todas as colunas de saída de um fluxo. Você pode passar um nome de fluxo opcional como o segundo argumento.
comparar preços Compara dois valores do mesmo tipo. Devolve um valor inteiro negativo se valer1 < valer2 ou 0 se valer1 == valor2, e devolve um valor positivo se valer1 > valer2.
concat Concatena um número variável de cadeias de caracteres juntas. Tal como o operador + com strings.
concatWS Concatena um número variável de cadeias de caracteres juntamente com um separador. O primeiro parâmetro é o separador.
cos Calcula um valor de cosseno.
Cosh Calcula um cosseno hiperbólico de um valor.
CRC32 Calcula o hash CRC32 de um conjunto de colunas com diferentes tipos de dados primitivos quando é fornecido um comprimento de bits. O comprimento do bit deve ser de valores 0 (), 256224, 256, 384, e 512. Podes usá-lo para calcular uma impressão digital para uma linha.
graus académicos Converte radianos em graus.
dividir Divide um par de números. O mesmo que o / operador.
dropEsquerda Remove tantos caracteres quanto o especificado do lado esquerdo da cadeia de caracteres. Se a queda solicitada exceder o comprimento da cadeia de caracteres, uma cadeia de caracteres vazia será retornada.
dropRight Remova tantos caracteres quanto especificado do lado direito da cadeia de caracteres. Se a queda solicitada exceder o comprimento da cadeia de caracteres, uma cadeia de caracteres vazia será retornada.
termina com Verifica se a cadeia de caracteres termina com a cadeia de caracteres fornecida.
igual a Usa o operador de comparação igual a . O mesmo que o == operador.
equalsIgnoreCase Usa o operador de comparação igual e ignora o caso. O mesmo que o <=> operador.
escape Escapa de uma cadeia de caracteres de acordo com um formato. Valores literais para formato aceitável são json, xml, ecmascript, html, e java.
EXPR Resulta em uma expressão de uma cadeia de caracteres. Equivalente a escrever a expressão numa forma não literal. Podes usá-lo para passar parâmetros como representações de cadeias.
fatorial Calcula o fatorial de um número.
falso Sempre retorna um valor falso. Use a função syntax(false()) se houver uma coluna chamada false.
andar Devolve o número inteiro maior não superior ao número.
deBase64 Decodifica a cadeia específica codificada em base64.
greater Usa o operador de comparação "maior que". O mesmo que o > operador.
maiorOrEqual Usa a comparação maior ou igual a operador. O mesmo que o >= operador.
maior Retorna o maior valor entre a lista de valores como entrada ignorando valores nulos. Retorna null se todas as entradas forem nulas.
hasColumn Verifica se há um valor de coluna por nome no fluxo. Você pode passar um nome de fluxo opcional como o segundo argumento. Os nomes das colunas conhecidos no momento do projeto devem ser endereçados apenas usando o seu nome. Entradas computadas não são suportadas, mas podes usar substituições de parâmetros.
hasError Verifica se a declaração com o ID fornecido está marcada como erro.
IFI Aplica um valor ou outro com base numa condição. Se o outro não for especificado, o valor é considerado NULL. Ambos os valores devem ser compatíveis (por exemplo, numérico ou string).
iifNull Devolve o primeiro item não nulo quando recebe dois ou mais inputs. Esta função é equivalente a coalesce.
initCap Converte a primeira letra de cada palavra em maiúsculas. As palavras são identificadas como separadas por espaço em branco.
instr Encontra a posição (base 1) da subcorda dentro de uma cadeia. Se não for encontrado, 0 é devolvido.
isDelete Verifica se a linha está marcada para exclusão. Para transformações que requerem mais do que um fluxo de entrada, pode passar o índice (baseado em 1) do fluxo. O índice do fluxo deve ser ou 1 ou 2, e o valor padrão é 1.
isError Verifica se a linha está marcada como erro. Para transformações que requerem mais do que um fluxo de entrada, pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2. O valor predefinido é 1.
isIgnore Verifica se a linha deve ser ignorada. Para transformações que requerem mais do que um fluxo de entrada, pode passar o índice (baseado em 1) do fluxo. O índice do fluxo deve ser 1 ou 2. O valor predefinido é 1.
isInsert Verifica se a linha está marcada para inserção. Para transformações que requerem mais do que um fluxo de entrada, pode passar o índice (baseado em 1) do fluxo. O índice do fluxo deve ser ou 1 ou 2. O valor predefinido é 1.
isMatch Verifica se a linha corresponde na pesquisa. Para transformações que requerem mais do que um fluxo de entrada, pode passar o índice (baseado em 1) do fluxo. O índice do fluxo deve ser 1 ou 2. O valor predefinido é 1.
isNull Verifica se o valor é NULL.
isUpdate Verifica se a linha está marcada para atualização. Para transformações que requerem mais do que um fluxo de entrada, pode passar o índice (baseado em 1) do fluxo. O índice do fluxo deve ser ou 1 ou 2. O valor predefinido é 1.
isUpsert Verifica se a linha está marcada para inserção. Para transformações que requerem mais do que um fluxo de entrada, pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2. O valor padrão é 1.
jaroWinkler Obtém a distância JaroWinkler entre duas cadeias de caracteres.
pelo menos Usa o operador de comparação menor ou igual a. O mesmo que o <= operador.
Esquerda Extrai uma subcadeia que começa no índice 1 com o número de caracteres. O mesmo que SUBSTRING(str, 1, n).
length Devolve o comprimento da cadeia.
menor Usa o operador de menor comparação. O mesmo que o < operador.
lesserOrEqual Usa o operador de comparação menor ou igual a. O mesmo que o <= operador.
Levenshtein Obtém a distância levenshtein entre duas cordas.
goste Usa um padrão com uma corda que é literalmente igualada. A exceção é o símbolo _ especial que corresponde a qualquer carácter na entrada (semelhante a .* nas posix expressões regulares).
Localizar Encontra a posição (baseada em 1) da substring dentro de uma string que inicia uma certa posição. Se a posição for omitida, comece pelo início da cadeia de caracteres. Se não for encontrado, 0 é devolvido.
registo Calcula o valor logarítmico. Pode fornecer uma base opcional ou, se usado, um número de Euler.
Log10 Calcula o valor logarítmico com base numa base de 10.
inferior Uma cadeia de caracteres em minúsculas.
LPAD A esquerda almofada a corda pelo acolchoamento fornecido até que tenha um certo comprimento. Se a cadeia de caracteres for igual ou maior que o comprimento, a cadeia de caracteres é aparada ao comprimento.
LTRIM A esquerda corta uma sequência de caracteres principais. Se o segundo parâmetro não for especificado, reduz o espaço em branco. Caso contrário, corta qualquer carácter especificado no segundo parâmetro.
MD5 Calcula o resumo MD5 de um conjunto de colunas com diferentes tipos de dados primitivos e devolve uma cadeia hexadecimal de 32 caracteres. Podes usá-lo para calcular uma impressão digital para uma linha.
menos Subtrai números. Subtrai o número de dias de uma data. Subtrai a duração de uma marca temporal. Subtrai dois carimbos temporais para obter a diferença em milissegundos. O mesmo que o - operador.
Mod Dá o módulo de um par de números. O mesmo que o % operador.
multiplicar Multiplica um par de números. O mesmo que o * operador.
negar Nega um número. Transforma números positivos em negativos e vice-versa.
nextSequence Retorna a próxima sequência exclusiva. O número é consecutivo apenas dentro de uma partição e é prefixado pelo ID da partição.
normalizar Normaliza o valor da cadeia para caracteres Unicode acentuados separados.
não Utiliza o operador de negação lógica.
nãoIgual Usa o operador de comparação não é igual a . O mesmo que o != operador.
nulo Devolve um NULL valor. Use a função syntax(null()) se houver uma coluna chamada null. Qualquer operação que o utilize resulta num NULL.
or Usa o operador lógico OR . O mesmo que ||.
pMod Dá o módulo positivo de um par de números.
partiçãoId Devolve o ID de partição atual em que se encontra a linha de entrada.
Alimentação Eleva um número ao poder de outro.
radianos Converte graus em radianos.
aleatório Devolve um número aleatório quando recebe uma semente opcional dentro de uma partição. A semente deve ser um valor fixo e é utilizada em conjunto com o ID da partição para produzir valores aleatórios.
regexExtrato Extrai uma substring correspondente para um padrão regex específico. O último parâmetro identifica o grupo de correspondência e assume o valor 1, caso seja omitido. Usa `<regex>` para corresponder a uma cadeia de caracteres sem usar escape.
regexMatch Verifica se a sequência corresponde ao padrão de expressão regular específico. Usa `<regex>` para corresponder a uma cadeia de caracteres sem usar escape.
regexSubstituir Substitui todas as ocorrências de um padrão regex por outra substring numa string específica. Usa `<regex>` para corresponder a uma cadeia de caracteres sem usar escape.
regexSplit Divide uma cadeia de caracteres com base em um delimitador baseado em regex e retorna uma matriz de cadeias de caracteres.
replace Substitui todas as ocorrências de uma subcadeia por outra subcadeia na cadeia específica. Se o último parâmetro for omitido, por defeito passa para uma cadeia vazia.
reverse Inverte uma cadeia de caracteres.
Certo Extrai uma substring com o número de caracteres desde a direita. O mesmo que SUBSTRING(str, LENGTH(str) - n, n).
rlike Verifica se a string corresponde ao padrão de expressão regular específico.
redondo Arredonda um número quando recebe uma escala opcional e um modo de arredondamento opcional. Se a escala for omitida, por defeito passa a 0. Se o modo for omitido, o padrão é ROUND_HALF_UP(5).
RPAD À direita, coloca a corda com o acolchoamento fornecido até que tenha um certo comprimento. Se a cadeia de caracteres for igual ou maior que o comprimento, a cadeia de caracteres é aparada ao comprimento.
Rtrim A direita corta uma sequência de caracteres à direita. Se o segundo parâmetro não for especificado, reduz o espaço em branco. Caso contrário, corta qualquer carácter especificado no segundo parâmetro.
SHA1 Calcula o resumo SHA-1 de um conjunto de colunas com diferentes tipos de dados primitivos e devolve uma cadeia hexadecimal de 40 caracteres. Podes usá-lo para calcular uma impressão digital para uma linha.
SHA2 Calcula o resumo SHA-2 de um conjunto de colunas com tipos de dados primitivos variados quando dado um comprimento de bit, que só pode ter valores 0 (256), 224, 256, 384, e 512. Podes usá-lo para calcular uma impressão digital para uma linha.
pecado Calcula um valor senoidal .
Sinh Calcula um valor sinusoidal hiperbólico.
Soundex Obtém o soundex código para a cadeia de caracteres.
split Divide uma cadeia de caracteres com base em um delimitador e retorna uma matriz de cadeias de caracteres.
SQRT Calcula a raiz quadrada de um número.
começaCom Verifica se a cadeia de caracteres começa com a cadeia de caracteres fornecida.
substring Extrai uma substring de um determinado comprimento de uma posição. A posição é baseada em 1. Se o comprimento for omitido, por padrão considera-se até ao final da string.
substringIndex Extrai a substring antes count das ocorrências do delimitador. Se count for positivo, tudo à esquerda do delimitador final (contando a partir da esquerda) é devolvido. Se count for negativo, tudo à direita do delimitador final (contando a partir da direita) é devolvido.
bronzeado Calcula um valor tangente.
Tanh Calcula um valor tangente hiperbólico.
Traduzir Substitui um conjunto de caracteres por outro conjunto de caracteres na cadeia. As personagens são substituídas uma a uma.
guarnição Corta uma sequência de caracteres à esquerda e à direita. Se o segundo parâmetro não for especificado, reduz o espaço em branco. Caso contrário, corta qualquer carácter especificado no segundo parâmetro.
verdadeiro Sempre retorna um valor verdadeiro. Use a função syntax(true()) se uma coluna for nomeada true.
typeMatch Corresponde ao tipo da coluna. Usado apenas em expressões de padrões. Número corresponde a curto, inteiro, longo, duplo, flutuante ou decimal. Integral corresponde a curto, inteiro, e longo. Frações correspondem a tipos de dados double, float e decimal. Datetime corresponde ao tipo de data ou tipo timestamp.
sem fuga Unescapes de uma cadeia de caracteres de acordo com um formato. Valores literais para formato aceitável são json, xml, ecmascript, html, e java.
superior Letras maiúsculas uma cadeia de caracteres.
UUID Retorna o UUID gerado.
XOR Dá o operador lógico XOR . O mesmo que o ^ operador.