Funções de expressão no mapeamento do fluxo 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 no Azure Data Factory e no Azure Synapse Pipelines. Este artigo aplica-se ao mapeamento de fluxos de dados. Se você é novo em transformações, consulte o artigo introdutório Transformar dados usando um fluxo de dados de mapeamento.

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

Lista de funções de expressão

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

Função de expressão Tarefa
ABS 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 a um carimbo de data/hora. Acrescenta uma matriz de tipo semelhante a outra. O mesmo que o operador +.
and Operador lógico E. O mesmo que &&.
Asin Calcula um valor seno inverso.
assertErrorMessages Retorna o mapa de todas as mensagens de declaraçã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. Os valores numéricos, de cadeia de caracteres e de data/hora podem ser comparados
bitwiseE Bitwise E operador em todos os tipos integrais. O mesmo que o operador Ads.
bitwiseOu Bitwise Ou operador em todos os tipos integrais. O mesmo que | operador.
bitwiseXor Bitwise Ou operador em todos os tipos integrais. O mesmo que | operador.
Blake2B Calcula o resumo de Blake2 do conjunto de colunas de vários tipos de dados primitivos com um comprimento de bit. O comprimento de bit só pode ser múltiplos de 8 entre 8 e 512. Ele pode ser usado para calcular uma impressão digital para uma linha.
blake2bbinário Calcula o resumo de Blake2 do conjunto de colunas de tipos de dados primitivos variáveis dado um comprimento de bit, que só pode ser múltiplos de 8 entre 8 & 512. Ele pode ser usado para calcular uma impressão digital para uma linha
caixa Com base em condições alternadas aplica-se um valor ou outro. Se o número de entradas for par, o outro será padronizado como NULL 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. Você pode passar um nome de fluxo opcional como o primeiro argumento e um segundo argumento opcional para retornar apenas colunas de desvio de 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 inteiro negativo se value1 value2, 0 if value1 == value2, positive value if value1 <> value2.
concat Concatena um número variável de cadeias de caracteres juntas. O mesmo que 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 do conjunto de colunas de tipos de dados primitivos variáveis dado um comprimento de bit. O comprimento do bit deve ser dos valores 0 (256), 224, 256, 384 ou 512. Ele pode ser usado para calcular uma impressão digital para uma linha.
graus académicos Converte radianos em graus.
dividir Divide o par de números. O mesmo que o / operador.
dropEsquerda Remove tantos 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 tantos 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.
termina com Verifica se a cadeia de caracteres termina com a cadeia de caracteres fornecida.
igual a Comparação é igual a operador. O mesmo que == operador.
equalsIgnoreCase Comparação é igual a operador, ignorando maiúsculas e minúsculas. O mesmo que <=> operador.
escape Escapa 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'.
EXPR Resulta em uma expressão de uma cadeia de caracteres. É equivalente a escrever a expressão em uma forma não literal e pode ser usado para passar parâmetros como representações de cadeia de caracteres.
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 de caracteres codificada em base64 fornecida.
greater Comparação maior operador. O mesmo que > operador.
maiorOrEqual Comparação maior ou igual ao operador. O mesmo que >= 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 de colunas conhecidos em tempo de design devem ser endereçados apenas pelo nome. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros.
hasError Verifica se a declaração com ID fornecida está marcada como erro.
IFI Com base em uma condição aplica-se um valor ou outro. Se outro não for especificado, é considerado NULL. Ambos os valores devem ser compatíveis (numérico, string...).
iifNull Dadas duas ou mais entradas, retorna o primeiro item não nulo. Esta função é equivalente a coalescência.
initCap Converte a primeira letra de cada palavra em maiúsculas. As palavras são identificadas como separadas por espaço em branco.
instr Localiza a posição(1 baseada) da substring dentro de uma cadeia de caracteres. 0 é retornado se não for encontrado.
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 1 ou 2 e 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 1 ou 2 e o valor padrão é 1.
isIgnore Verifica se a linha está marcada para 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 1 ou 2 e 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 1 ou 2 e o valor padrão é 1.
isMatch Verifica se a linha corresponde 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 e 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 1 ou 2 e 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 1 ou 2 e o valor padrão é 1.
jaroWinkler Obtém a distância JaroWinkler entre duas cadeias de caracteres.
pelo menos Comparação menor ou igual operador. O mesmo que <= operador.
Esquerda Extrai uma substring iniciada no índice 1 com o número de caracteres. O mesmo que SUBSTRING(str, 1, n).
length Devolve o comprimento da cadeia.
menor Comparação menos operador. O mesmo que < operador.
lesserOrEqual Comparação menor ou igual operador. O mesmo que <= operador.
Levenshtein Obtém a distância levenshtein entre duas cordas.
goste O padrão é uma cadeia de caracteres que é correspondida literalmente. As exceções são os seguintes símbolos especiais: _ corresponde a qualquer caractere na entrada (semelhante a. em posix expressões regulares)
Localizar Localiza a posição(1 baseada) da substring dentro de uma cadeia de caracteres iniciando uma determinada posição. Se a posição for omitida, ela será considerada desde o início da cadeia de caracteres. 0 é retornado se não for encontrado.
registo Calcula o valor do log. Uma base opcional pode ser fornecida ou um número Euler, se usado.
Log10 Calcula o valor do log com base na base 10.
inferior Uma cadeia de caracteres em minúsculas.
LPAD Esquerda almofada a corda pelo preenchimento fornecido até que seja de um certo comprimento. Se a string for igual ou maior que o comprimento, ela será cortada para o comprimento.
LTRIM A esquerda corta uma sequência de caracteres principais. Se o segundo parâmetro não for especificado, ele cortará o espaço em branco. Caso contrário, ele corta qualquer caractere especificado no segundo parâmetro.
MD5 Calcula o resumo MD5 do conjunto de colunas de tipos de dados primitivos variáveis e retorna uma cadeia de caracteres hexadecimal de 32 caracteres. Ele pode ser usado para calcular uma impressão digital para uma linha.
menos Subtrai números. Subtraia o número de dias de uma data. Subtraia a duração de um carimbo de data/hora. Subtraia dois carimbos de data/hora para obter a diferença em milissegundos. O mesmo que o operador - .
Mod Módulo de par de números. O mesmo que o operador %.
multiplicar Multiplica 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 partitionId.
normalizar Normaliza o valor da cadeia de caracteres para separar caracteres unicode acentuados.
não Operador de negação lógica.
nãoIgual Comparação não é igual a operador. O mesmo que != operador.
nulo Retorna um valor NULL. Use a função syntax(null()) se houver uma coluna chamada 'null'. Qualquer operação que use resultará em um NULL.
ou Operador lógico OR. O mesmo que ||.
pMod Módulo positivo de par de números.
partiçãoId Retorna o ID de partição atual em que a linha de entrada está.
Alimentação Eleva um número ao poder de outro.
radianos Converte graus em radianos
aleatório Retorna um número aleatório dado uma semente opcional dentro de uma partição. A semente deve ser um valor fixo e é usada com o partitionId para produzir valores aleatórios
regexExtrato Extraia uma substring correspondente para um determinado padrão de regex. O último parâmetro identifica o grupo de correspondência e é padronizado para 1 se omitido. Use `<regex>` (aspas posteriores) para corresponder a uma cadeia de caracteres sem escapar.
regexMatch Verifica se a cadeia de caracteres corresponde ao padrão regex fornecido. Use `<regex>` (aspas posteriores) para corresponder a uma cadeia de caracteres sem escapar.
regexSubstituir Substitua todas as ocorrências de um padrão regex por outra substring na string dada Use `<regex>` (back quote) para corresponder a uma string sem escapar.
regexSplit Divide uma cadeia de caracteres com base em um delimitador baseado em regex e retorna uma matriz de cadeias de caracteres.
replace Substitua todas as ocorrências de uma substring por outra substring na cadeia de caracteres fornecida. Se o último parâmetro for omitido, o padrão será a cadeia de caracteres vazia.
reverse Inverte uma cadeia de caracteres.
Certo 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 fornecido.
redondo Arredonda um número com uma escala opcional e um modo de arredondamento opcional. Se a escala for omitida, o padrão será 0. Se o modo for omitido, o padrão será ROUND_HALF_UP(5). Os valores para arredondamento incluem
RPAD Almofadas direitas a corda pelo preenchimento fornecido até que ela tenha um certo comprimento. Se a string for igual ou maior que o comprimento, ela será cortada para o comprimento.
Rtrim A direita corta uma sequência de caracteres à direita. Se o segundo parâmetro não for especificado, ele cortará o espaço em branco. Caso contrário, ele corta qualquer caractere especificado no segundo parâmetro.
SHA1 Calcula o resumo SHA-1 do conjunto de colunas de tipos de dados primitivos variáveis e retorna uma cadeia de caracteres hexadecimais de 40 caracteres. Ele pode ser usado para calcular uma impressão digital para uma linha.
SHA2 Calcula o resumo SHA-2 do conjunto de colunas de tipos de dados primitivos variáveis dado um comprimento de bit, que só pode ser de valores 0(256), 224, 256, 384, 512. Ele pode ser usado 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, o padrão será o fim da cadeia de caracteres.
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 Substitua um conjunto de caracteres por outro conjunto de caracteres na cadeia de caracteres. Os personagens têm 1 a 1 substituição.
guarnição Corta uma sequência de caracteres à esquerda e à direita. Se o segundo parâmetro não for especificado, ele cortará o espaço em branco. Caso contrário, ele corta qualquer caractere especificado no segundo parâmetro.
verdadeiro Sempre retorna um valor verdadeiro. 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 de padrão.número corresponde a curto, inteiro, longo, duplo, flutuante ou decimal, corresponde integral curto, inteiro, longo, fracionário corresponde a double, float, decimal e datetime corresponde a data ou tipo de carimbo de data/hora.
sem fuga Unescapes 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'.
superior Letras maiúsculas uma cadeia de caracteres.
UUID Retorna o UUID gerado.
XOR Operador XOR lógico. O mesmo que ^ operador.