Funções de expressão em fluxo de dados de mapeamento

  • Artigo

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um 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 avaliação gratuita!

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

Os artigos a seguir fornecem detalhes sobre as funções de expressão com suporte pelo Azure Data Factory e pelo Azure Synapse Analytics nos fluxos de dados de mapeamento.

Lista de funções de expressão

Nos pipelines do Synapse e Data Factory, 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 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 Operador AND lógico. Similar a &&.
asin Calcula um valor de inverso do seno.
assertErrorMessages Retorna um mapa de todas as mensagens de declaraçã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. Os valores numéricos, de cadeia de caracteres e de datetime podem ser comparados
bitwiseAnd Operador And bit a bit em tipos integrais. O mesmo que operador de design.
bitwiseOr Operador Or bit a bit em tipos integrais. O mesmo que o | operador.
bitwiseXor Operador Or bit a bit em tipos integrais. O mesmo que o | operador.
blake2b Calcula o resumo Blake2 do conjunto de colunas de tipos de dados primitivos variados de acordo com um comprimento de bit. O comprimento do bit só pode ser múltiplo de 8 entre 8 e 512. Pode ser usado para calcular uma impressão digital para uma linha.
blake2bBinary Calcula o resumo Blake2 do conjunto de colunas de tipos de dados primitivos variados, dado um comprimento de bits, que só pode ser múltiplos de 8 entre 8 & 512. Pode ser usado para calcular uma impressão digital de uma linha
case Com base em condições alternadas, aplica-se um valor ou o outro. Se o número de entradas for par, o outro é padronizado como NULL na ú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 o primeiro argumento e um segundo argumento opcional para retornar apenas colunas de 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, 0 se value1 == value2, um valor positivo se value1 > value2.
concat Concatena um número variável de cadeias de caracteres juntas. Similar ao 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 do conjunto de colunas de diferentes tipos de dados primitivos dado um comprimento de bits. O comprimento do bit deve ser dos valores 0 (256), 224, 256, 384 ou 512. Pode ser usado para calcular uma impressão digital para uma linha.
degrees Converter radianos em graus.
divide Divide o par de números. Similar ao operador /.
dropLeft Remove o maior número de caracteres da 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 o maior número de caracteres da 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 Operador de comparação equals. Similar ao operador ==.
equalsIgnoreCase Operador de comparação equals ignorando maiúsculas e minúsculas. O mesmo que o operador <=>.
escape Escapa uma cadeia de caracteres de acordo com um formato. Os valores literais para o formato aceitável são "json", "xml", "ecmascript", "html", "java'.
expr Resulta em uma expressão de uma cadeia de caracteres. É equivalente a gravar a expressão em um formulário não literal e pode ser usado 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 determinada.
greater Operador de comparação greater. O mesmo que o operador >.
greaterOrEqual Operador de comparação greater than or equal. O mesmo que o 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 tempo de design devem ser tratados apenas por seus nomes. Não há suporte a entradas computadas, mas você pode usar substituições de parâmetro.
hasError Verifica se a declaração com a ID fornecida está marcada como um erro.
iif Com base em uma condição, aplica-se um valor ou o outro. Se "Outros" não for especificado, será considerado NULL. Ambos os valores devem ser compatíveis (numérico, cadeia de caracteres...).
iifNull Dada duas ou mais entradas, retorna o primeiro item não nulo. Essa função é equivalente a unir.
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 subcadeia de caracteres dentro de uma cadeia de caracteres. Retorna 0 se não encontrado.
isDelete Verifica se a linha está marcada para exclusão. No caso de transformações que usem mais de um fluxo de entrada, você pode transmitir o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2 e o valor padrão é 1.
isError Verifica se a linha está marcada como erro. No caso de transformações que usem mais de um fluxo de entrada, você pode transmitir o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2 e o valor padrão é 1.
isIgnore Verifica se a linha está marcada para ser ignorada. No caso de transformações que usem mais de um fluxo de entrada, você pode transmitir o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2 e o valor padrão é 1.
isInsert Verifica se a linha está marcada para inserção. No caso de transformações que usem mais de um fluxo de entrada, você pode transmitir o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2 e o valor padrão é 1.
isMatch Verifica se a linha é correspondida na pesquisa. No caso de transformações que usem mais de um fluxo de entrada, você pode transmitir o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2 e o valor padrão é 1.
isNull Verifica se o valor é NULL.
isUpdate Verifica se a linha está marcada para atualização. No caso de transformações que usem mais de um fluxo de entrada, você pode transmitir o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2 e o valor padrão é 1.
isUpsert Verifica se a linha está marcada para inserção. No caso de transformações que usem mais de um fluxo de entrada, você pode transmitir o índice (baseado em 1) do fluxo. O índice de fluxo deve ser 1 ou 2 e o valor padrão é 1.
jaroWinkler Obtém a distância JaroWinkler entre duas cadeias de caracteres.
least Operador de comparação lesser than or equal. O mesmo que o operador <=.
esquerda Extrai um início de subcadeia de caracteres no índice 1 com o número de caracteres. Similar a SUBSTRING(str, 1, n).
length Retorna o comprimento da cadeia de caracteres.
lesser Operador de comparação less. O mesmo que o operador <.
lesserOrEqual Operador de comparação lesser than or equal. O mesmo que o operador <=.
levenshtein Obtém a distância Levenshtein entre duas cadeias de caracteres.
like O padrão é uma cadeia de caracteres com correspondência literal. As exceções são os seguintes símbolos especiais: _ corresponde a um caractere na entrada (semelhante a. em expressões regulares posix)
locate Localiza a posição (baseada em 1) da subcadeia de caracteres dentro de uma cadeia de caracteres começando de uma certa posição. Se a posição for omitida, será considerada desde o começo da cadeia de caracteres. Retorna 0 se não encontrado.
log Calcula o valor de log. Uma base opcional pode ser fornecida caso um número de Euler seja usado.
log10 Calcula o valor do log com base em 10.
lower Coloca em minúsculas todos os caracteres de uma cadeia de caracteres.
lpad Preenche à esquerda a cadeia de caracteres com o preenchimento fornecido até que esta alcance um determinado comprimento. Se a cadeia de caracteres for igual ou maior que o tamanho, ela será cortada no tamanho.
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 código hash MD5 do conjunto de colunas de diferentes tipos de dados primitivos e retorna uma cadeia hexadecimal de 32 caracteres. Pode ser usado para calcular uma impressão digital para 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 carimbos de data/hora para obter a diferença em milissegundos. Similar ao operador -.
mod Módulo de par de números. Similar ao operador %.
multiply Multiplica o 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 somente dentro de uma partição e é prefixado pela partitionId.
normalize Normaliza o valor da cadeia de caracteres para separar caracteres Unicode acentuados.
not Operador de negação lógica.
notEquals Operador de comparação not equals. Similar ao operador !=.
null Retorna um valor NULL. Use a função syntax(null()) se houver uma coluna chamada "null". Qualquer operação que a empregar resultará em NULL.
or Operador OR lógico. Similar a ||.
pMod Módulo positivo de 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 dado uma semente opcional em uma partição. A semente deve ser um valor fixo e é usada com a partitionId para produzir valores aleatórios
regexExtract Extrai uma subcadeia de caracteres correspondente a um determinado padrão regex. O último parâmetro identifica o grupo de correspondências e será padronizado como 1 se omitido. Use `<regex>` (acento grave) para corresponder a uma cadeia de caracteres sem escape.
regexMatch Verifica se a cadeia de caracteres corresponde ao determinado padrão regex. Use `<regex>` (acento grave) para corresponder a uma cadeia de caracteres sem escape.
regexReplace Substituir todas as ocorrências de um padrão regex por outra substring na cadeia de caracteres determinada. Use `<regex>` (acento grave) para corresponder a uma cadeia de caracteres 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 determinada. Se o último parâmetro for omitido, ele será padronizado como uma cadeia de caracteres vazia.
reverse Inverte uma cadeia de caracteres.
direita Extrai uma subcadeia de caracteres com o número de caracteres à direita. Similar a SUBSTRING(str, LENGTH(str) - n, n).
rlike Verifica se a cadeia de caracteres corresponde ao determinado padrão regex.
round Arredonda um número com determinada escala opcional e um modo de arredondamento opcional. Se a escala for omitida, será padronizada como 0. Se o modo for omitido, será padronizado como ROUND_HALF_UP(5). Os valores para arredondamento incluem
rpad Preenche à direita a cadeia de caracteres com o preenchimento fornecido até que esta alcance um determinado comprimento. Se a cadeia de caracteres for igual ou maior que o tamanho, ela será cortada no tamanho.
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 digest SHA-1 do conjunto de colunas de diferentes tipos de dados primitivos e retorna uma cadeia hexadecimal de 40 caracteres. Pode ser usado para calcular uma impressão digital para uma linha.
sha2 Calcula o digest SHA-2 do conjunto de colunas de diferentes tipos de dados primitivos dado um comprimento de bits, que pode ser apenas de valores 0 (256), 224, 256, 384, 512. Pode ser usado para calcular uma impressão digital para 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 será padronizado como 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. Substituição de caracteres na proporção de 1 para 1.
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 houver uma coluna chamada 'true'.
typeMatch Corresponde ao tipo da coluna. Só pode ser usado em expressões padrão: number corresponde a curto, inteiro, longo, duplo, flutuante ou decimal; integral corresponde a curto, inteiro, longo; fractional corresponde a duplo, flutuante, decimal; e datetime corresponde à data ou ao tipo de carimbo de data/hora.
unescape Ignora o escape de uma cadeia de caracteres de acordo com um formato. Os valores literais para o formato aceitável são "json", "xml", "ecmascript", "html", "java'.
upper Coloca em maiúsculas todos os caracteres de uma cadeia de caracteres.
uuid Retorna o UUID gerado.
xor Operador lógico XOR. Similar ao operador ^.

Conteúdo relacionado