Compartilhar via

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

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

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

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

Este artigo fornece detalhes sobre as funções de expressão compatíveis com o Azure Data Factory e o Azure Synapse Analytics no mapeamento de fluxos de dados.

Lista de funções de expressão

Em pipelines do Azure Data Factory e do Azure Synapse Analytics, use a linguagem de expressão do recurso de fluxo de dados de mapeamento para configurar as transformações de dados.

Função de expressão Tarefa
abs Fornece o valor absoluto de um número.
acos Calcula um valor de inverso do cosseno.
adicionar Adiciona um par de cadeias de caracteres ou números. Adiciona uma data a um número de dias. Adiciona uma duração a um carimbo de data/hora. Acrescenta uma matriz de tipo semelhante a outra. Similar ao operador +.
and Usa o operador lógico AND . O mesmo que &&.
asin Calcula um valor de inverso do seno.
assertErrorMessages Retorna um mapa de todas as mensagens de asserção.
atan Calcula um valor inverso da tangente.
atan2 Retorna o ângulo em radianos entre o eixo x positivo de um plano e o ponto dado pelas coordenadas.
between Verifica se o primeiro valor está entre dois outros valores, inclusive. Você pode comparar valores numéricos, strings e datetime.
bitwiseAnd Usa o operador bit a bit And em todos os tipos integrais. Similar ao operador &.
bitwiseOr Usa o operador bit a bit Or em todos os tipos integrais. Similar ao operador |.
bitwiseXor Usa o operador bit a bit Or em todos os tipos integrais. Similar ao operador |.
blake2b Calcula o resumo Blake2 de um conjunto de colunas de tipos de dados primitivos variados quando é fornecido um comprimento de bits. O comprimento do bit só pode ser múltiplo de 8 entre 8 e 512. Você pode usá-lo para calcular uma impressão digital de uma linha.
blake2bBinary Calcula o resumo Blake2 de um conjunto de colunas de tipos de dados primitivos variados quando é fornecido um comprimento de bits, que pode ser apenas múltiplos de 8 entre 8 e 512. Você pode usá-lo para calcular uma impressão digital de uma linha.
case Aplica um valor ou outro com base em condições que alternam. Se o número de entradas for par, o outro será definido como NULL para a última condição.
cbrt Calcula a raiz cúbica de um número.
ceil Retorna o menor 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. Você pode passar um nome de fluxo opcional como primeiro argumento e um segundo argumento opcional para retornar apenas colunas com descompasso de esquema.
columns Obtém os valores de todas as colunas de saída de um fluxo. Você pode transmitir um nome de fluxo opcional como o segundo argumento.
compare Compara dois valores do mesmo tipo. Retorna um inteiro negativo se value1 < value2 ou 0 if value1 == value2 e retorna um valor positivo se value1 > value2.
concat Concatena um número variável de cadeias de caracteres juntas. O mesmo que o + operador com cadeias de caracteres.
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 tipos de dados primitivos variados quando especificado um comprimento em bits. O comprimento do bit deve ser de valores 0 (256), 224, , 256e 384512. Você pode usá-lo para calcular uma impressão digital de uma linha.
degrees Converter radianos em graus.
divide Divide um par de números. Similar ao operador /.
dropLeft Remove quantos caracteres forem especificados à esquerda da cadeia de caracteres. Se a queda solicitada exceder o comprimento da cadeia de caracteres, uma cadeia de caracteres vazia será retornada.
dropRight Remove quantos caracteres forem especificados à direita da cadeia de caracteres. Se a queda solicitada exceder o comprimento da cadeia de caracteres, uma cadeia de caracteres vazia será retornada.
endsWith Verifica se a cadeia de caracteres termina com a cadeia de caracteres fornecida.
equals Usa o operador de comparação é igual a. Similar ao operador ==.
equalsIgnoreCase Usa o operador de comparação é igual a e ignora maiúsculas e minúsculas. Similar ao operador <=>.
escape Escapa uma cadeia de caracteres de acordo com um formato. Os valores literais para o formato aceitável sãojson, , xml, ecmascripte htmljava.
expr Resulta em uma expressão de uma cadeia de caracteres. Equivalente a escrever a expressão em uma forma não literal. Você pode usá-lo para passar parâmetros como representações de cadeia de caracteres.
factorial Calcula o fatorial de um número.
false Sempre retorna um valor false. Use a função syntax(false()) se houver uma coluna chamada false.
floor Retorna o maior inteiro não superior ao número.
fromBase64 Decodifica a cadeia de caracteres codificada em base64 específica.
greater Usa o operador de comparação maior que. Similar ao operador >.
greaterOrEqual Usa o operador de comparação maior ou igual a. Similar ao operador >=.
greatest Retorna o maior valor entre a lista de valores como entrada e ignora os valores null. Retorna null se todas as entradas forem null.
hasColumn Verifica um valor de coluna de acordo com o nome no fluxo. Você pode transmitir um nome de fluxo opcional como o segundo argumento. Os nomes de coluna conhecidos no momento de design devem ser referenciados usando apenas o nome. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro.
hasError Verifica se a afirmação com o ID fornecido está registrada como um erro.
iif Aplica um valor ou outro com base em uma condição. Se o outro não for especificado, o valor será considerado NULL. Ambos os valores devem ser compatíveis (por exemplo, numérico ou cadeia de caracteres).
iifNull Retorna o primeiro item não nulo quando dado duas ou mais entradas. Essa função é equivalente a coalesce.
initCap Converte a primeira letra de cada palavra em maiúscula. Palavras são identificadas como separadas por espaços em branco.
instr Localiza a posição (baseada em 1) da substring de caracteres dentro de uma cadeia de caracteres. Se não for encontrado, 0 será retornado.
isDelete Verifica se a linha está marcada para exclusão. Para transformações que levam mais de um fluxo de entrada, você pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser ou 1 , 2e o valor padrão é 1.
isError Verifica se a linha está marcada como erro. Para transformações que levam mais de um fluxo de entrada, você pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser ou 1 ou 2. O valor padrão é 1.
isIgnore Verifica se a linha deve ser ignorada. Para transformações que levam mais de um fluxo de entrada, você pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser ou 1 ou 2. O valor padrão é 1.
isInsert Verifica se a linha está marcada para inserção. Para transformações que levam mais de um fluxo de entrada, você pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser ou 1 ou 2. O valor padrão é 1.
isMatch Verifica se a linha é correspondida na pesquisa. Para transformações que levam mais de um fluxo de entrada, você pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2. O valor padrão é 1.
isNull Verifica se o valor é NULL.
isUpdate Verifica se a linha está marcada para atualização. Para transformações que levam mais de um fluxo de entrada, você pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser ou 1 ou 2. O valor padrão é 1.
isUpsert Verifica se a linha está marcada para inserção. Para transformações que levam mais de um fluxo de entrada, você pode passar o índice (baseado em 1) do fluxo. O índice de fluxo deve ser ou 1 ou 2. O valor padrão é 1.
jaroWinkler Obtém a distância JaroWinkler entre duas cadeias de caracteres.
least Usa o operador de comparação menor ou igual a. Similar ao operador <=.
left Extrai uma substring começando no índice 1 com uma quantidade específica de caracteres. O mesmo que SUBSTRING(str, 1, n).
length Retorna o comprimento da cadeia de caracteres.
lesser Usa o operador de comparação menor que. Similar ao operador <.
lesserOrEqual Usa o operador de comparação menor ou igual a. Similar ao operador <=.
levenshtein Obtém a distância Levenshtein entre duas cadeias de caracteres.
like Usa um padrão com uma cadeia que é correspondida literalmente. A exceção é o símbolo _ especial que corresponde a qualquer caractere na entrada (semelhante a .* em posix expressões regulares).
locate Encontra a posição (base 1) da substring em uma cadeia que começa em uma determinada posição. Se a posição for omitida, comece desde o início da cadeia de caracteres. Se não for encontrado, 0 será retornado.
log Calcula o valor do logaritmo. Você pode fornecer uma base opcional ou um número de Euler, se usado.
log10 Calcula o valor do log com base em uma base 10.
lower Coloca em minúsculas todos os caracteres de uma cadeia de caracteres.
lpad Preenche à esquerda a cadeia pelo preenchimento fornecido até que ela tenha um determinado comprimento. Se a cadeia de caracteres for igual ou maior que o comprimento, a cadeia de caracteres será cortada até o comprimento.
ltrim Corta uma cadeia de caracteres inicial à esquerda. Se o segundo parâmetro não for especificado, ele cortará o espaço em branco. Caso contrário, ele cortará qualquer caractere especificado no segundo parâmetro.
md5 Calcula o resumo MD5 de um conjunto de colunas de diferentes tipos de dados primitivos e retorna uma cadeia de caracteres hexáxe de 32 caracteres. Você pode usá-lo para calcular uma impressão digital de uma linha.
minus Subtrai números. Subtrai o número de dias de uma data. Subtrai a duração de um carimbo de data/hora. Subtrai dois timestamps para obter a diferença em milissegundos. Similar ao operador -.
mod Fornece o módulo de um par de números. Similar ao operador %.
multiply Multiplica um par de números. Similar ao operador *.
negate Torna um número negativo. 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 pela ID da partição.
normalize Normaliza o valor da cadeia de caracteres para separar caracteres Unicode acentuados.
not Usa o operador de negação lógica.
notEquals Usa o operador de comparação não igual a. Similar ao operador !=.
nulo Retorna um NULL valor. Use a função syntax(null()) se houver uma coluna chamada null. Qualquer operação que a use resulta em um NULL.
or Usa o operador lógico OR . O mesmo que ||.
pMod Fornece o módulo positivo de um par de números.
partitionId Retorna a ID da partição atual na qual a linha de entrada está.
power Eleva um número à potência de outro.
radians Converte graus em radianos.
random Retorna um número aleatório quando uma semente opcional é fornecida dentro de uma partição. A semente deve ser um valor fixo e é utilizada juntamente com o identificador da partição para produzir valores aleatórios.
regexExtract Extrai uma subcadeia de caracteres correspondente para um padrão regex específico. O último parâmetro identifica o grupo de correspondência e o valor padrão é 1 se o parâmetro for omitido. Use `<regex>` para corresponder a uma cadeia sem escape.
regexMatch Verifica se a cadeia de caracteres corresponde ao padrão regex específico. Use `<regex>` para corresponder a uma cadeia sem escape.
regexReplace Substitui todas as ocorrências de um padrão regex por outra subcadeia de caracteres na cadeia de caracteres específica. Use `<regex>` para corresponder a uma cadeia sem escape.
regexSplit Divide uma cadeia de caracteres com base em um delimitador baseado no regex e retorna uma matriz de cadeias de caracteres.
substitui Substitui todas as ocorrências de uma subcadeia de caracteres por outra subcadeia de caracteres na cadeia de caracteres específica. Se o último parâmetro for omitido, ele usará como padrão uma cadeia de caracteres vazia.
reverse Inverte uma cadeia de caracteres.
direita Extrai uma substring com o número de caracteres da direita. O mesmo que SUBSTRING(str, LENGTH(str) - n, n).
rlike Verifica se a cadeia de caracteres corresponde ao padrão regex específico.
round Arredonda um número quando dada uma escala opcional e um modo de arredondamento opcional. Se a escala for omitida, assume-se o padrão 0. Se o modo for omitido, ele usará como padrão ROUND_HALF_UP(5).
rpad Preenche à direita a cadeia pelo preenchimento fornecido até que ela tenha um determinado comprimento. Se a cadeia de caracteres for igual ou maior que o comprimento, a cadeia de caracteres será cortada até o comprimento.
rtrim Corta uma cadeia de caracteres final. Se o segundo parâmetro não for especificado, ele cortará o espaço em branco. Caso contrário, ele cortará qualquer caractere especificado no segundo parâmetro.
sha1 Calcula o resumo SHA-1 de um conjunto de colunas de diferentes tipos de dados primitivos e retorna uma cadeia de caracteres hexáxe de 40 caracteres. Você pode usá-lo para calcular uma impressão digital de uma linha.
sha2 Calcula o resumo SHA-2 de um conjunto de colunas de diferentes tipos de dados primitivos quando dado um comprimento de bit, que só pode ser de valores 0 (256), 224, 256, e 384512. Você pode usá-lo para calcular uma impressão digital de uma linha.
sin Calcula um valor de seno.
sinh Calcula um valor de seno hiperbólico.
soundex Obtém o código soundex da 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.
startsWith Verifica se a cadeia de caracteres começa com a cadeia fornecida.
substring Extrai uma subcadeia de caracteres de um determinado comprimento a partir de uma posição. A posição é baseada em 1. Se o comprimento for omitido, ele usará como padrão o final da cadeia de caracteres.
substringIndex Retorna a substring antes de count ocorrências do delimitador. Se count for positivo, tudo à esquerda do delimitador final (contando da esquerda) será retornado. Se count for negativo, tudo à direita do delimitador final (contando da direita) será retornado.
tan Calcula um valor de tangente.
tanh Calcula um valor de tangente hiperbólica.
translate Substitui um conjunto de caracteres por outro conjunto de caracteres na cadeia de caracteres. Os caracteres têm substituição um para um.
cortar Apara uma cadeia de caracteres inicial e final. Se o segundo parâmetro não for especificado, ele cortará o espaço em branco. Caso contrário, ele cortará qualquer caractere especificado no segundo parâmetro.
true Sempre retorna um valor true. Use a função syntax(true()) se uma coluna for nomeada true.
typeMatch Corresponde ao tipo da coluna. Usado somente em expressões de padrão. O número corresponde a short, integer, long, double, float ou decimal. O número integral corresponde a short, integer e long. O número fracionário corresponde a double, float e decimal. Datetime corresponde ao tipo de carimbo de data ou hora.
unescape Ignora o escape de uma cadeia de caracteres de acordo com um formato. Os valores literais para o formato aceitável sãojson, , xml, ecmascripte htmljava.
upper Coloca em maiúsculas todos os caracteres de uma cadeia de caracteres.
uuid Retorna o UUID gerado.
xor Fornece o operador lógico XOR . Similar ao operador ^.

Conteúdo relacionado

  • Last updated on