Expressões e funções do Data Factory no Microsoft Fabric

Este artigo fornece detalhes sobre expressões e funções compatíveis com o Data Factory no Microsoft Fabric.

Expressions

Os valores de expressão na definição podem ser literais ou expressões que são avaliadas em runtime. Por exemplo:

"value"

or

"@pipeline().parameters.password"

As expressões podem aparecer em qualquer lugar em um valor de cadeia de caracteres e sempre resultar em outro valor de cadeia de caracteres. Se um valor for uma expressão, o corpo da expressão será extraído removendo o sinal (@). Se uma cadeia de caracteres literal for necessária que comece com @, ela deverá ser escapada usando @@. Os exemplos a seguir mostram como as expressões são avaliadas.

Expressões também podem aparecer dentro de cadeias de caracteres, usando um recurso chamado interpolação de cadeia de caracteres em @{ ... }que as expressões são encapsuladas. Por exemplo: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Usando a interpolação de cadeia de caracteres, o resultado é sempre uma cadeia de caracteres. Digamos que eu tenha definido myNumber como 42 e myString como foo:

Nas atividades de fluxo de controle, como a atividade ForEach, você pode fornecer uma matriz para ser iterada para os itens de propriedade e usar @item() para iterar em uma única enumeração na atividade ForEach. Por exemplo, se os itens forem uma matriz: [1, 2, 3], @item() retornará 1 na primeira iteração, 2 na segunda iteração e 3 na terceira iteração. Você também pode usar @range(0,10) uma expressão semelhante para iterar 10 vezes, começando com 0 terminando com 9.

Você pode usar @activity('nome da atividade') para capturar a saída da atividade e tomar decisões. Considere uma atividade da Web chamada Web1. Para colocar a saída da primeira atividade no corpo do segundo, a expressão geralmente se parece com: @activity('Web1').output ou @activity('Web1').output.data ou algo semelhante, dependendo da aparência da saída da primeira atividade.

Exemplos

Exemplo de expressão complexa

O exemplo abaixo mostra um exemplo complexo que faz referência a um sub-campo profundo de saída de atividade. Para fazer referência a um parâmetro de pipeline que é avaliado como um subcampo, use a sintaxe [] em vez do operador dot(.) (como no caso de subfield1 e subfield2), como parte de uma saída de atividade.

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

Criar arquivos dinamicamente e nomeá-los é um padrão comum. Vamos explorar alguns exemplos dinâmicos de nomenclatura de arquivo.

• Acrescente Data a um nome de arquivo: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
• Acrescentar DateTime no fuso horário do cliente: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
• Tempo de gatilho de acréscimo: @concat('Test_', pipeline().TriggerTime)
• Gere um nome de arquivo personalizado em um fluxo de dados de mapeamento ao gerar para um único arquivo com data: 'Test_' + toString(currentDate()) + '.csv'

Nos casos acima, quatro nomes de arquivo dinâmicos são criados começando com Test_.

Editor de conteúdo dinâmico

O editor de conteúdo dinâmico escapa automaticamente dos caracteres em seu conteúdo quando você termina a edição. Por exemplo, o conteúdo a seguir no editor de conteúdo é uma interpolação de cadeia de caracteres com uma função de expressão.

"@{toUpper('myData')}"

O editor de conteúdo dinâmico converte conteúdo acima em expressão "@{toUpper('myData')}". O resultado dessa expressão é a cadeia de caracteres formatada mostrada abaixo.

"MYDATA"

Substituindo caracteres especiais

O editor de conteúdo dinâmico escapa automaticamente de caracteres como aspa dupla, barra invertida no conteúdo quando você termina a edição. Isso causará problemas se você quiser substituir o feed ou a guia de linha usando \n, \t na função replace(). Você pode editar seu conteúdo dinâmico no modo de exibição de código para remover o extra \ na expressão ou pode seguir as etapas abaixo para substituir caracteres especiais usando a linguagem de expressão:

1. Codificação de URL em relação ao valor da cadeia de caracteres original
2. Substitua a cadeia de caracteres codificada por URL, por exemplo, feed de linha (%0A), retorno de carro(%0D), guia horizontal(%09).
3. Decodificação de URL

Por exemplo, companyName variável com um caractere de nova linha em seu valor, a expressão @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) pode remover o caractere de nova linha.

Contoso- Corporation

Escape do caractere de aspa única

As funções de expressão usam aspas simples para parâmetros de valor de cadeia de caracteres. Use duas aspas simples para escapar de um ' caractere em funções de cadeia de caracteres. Por exemplo, a expressão @concat('Baba', '''s ', 'book store') retornará abaixo do resultado.

Baba's book store

Variáveis de escopo de pipeline

Essas variáveis do sistema podem ser referenciadas em qualquer lugar no pipeline.

Functions

Você pode chamar funções dentro de expressões. As seções a seguir fornecem informações sobre as funções que podem ser usadas em uma expressão.

Funções de data

Funções de cadeia de caracteres

Para trabalhar com cadeias de caracteres, você pode usar essas funções de cadeia de caracteres e também algumas funções de coleção. As funções de cadeia de caracteres funcionam somente em cadeias de caracteres.

Funções de coleção

Para trabalhar com coleções, geralmente matrizes, cadeias de caracteres e, às vezes, dicionários, você pode usar essas funções de coleção.

Funções lógicas

Essas funções são úteis dentro das condições, podem ser usadas para avaliar qualquer tipo de lógica.

Funções de conversão

Essas funções são usadas para converter entre cada um dos tipos nativos no idioma:

• cadeia
• inteiro
• derivar
• boolean
• Matrizes
• Dicionários

Funções matemática

Essas funções podem ser usadas para qualquer tipo de número: inteiros e floats.

Referência de função

Esta seção lista todas as funções disponíveis em ordem alfabética.

adicionar

Retorne o resultado da adição de dois números.

add(<summand_1>, <summand_2>)

Exemplo

Este exemplo adiciona os números especificados:

add(1, 1.5)

E retorna este resultado: 2.5

addDays

Adicione um número de dias a um carimbo de data/hora.

addDays('<timestamp>', <days>, '<format>'?)

Exemplo 1

Este exemplo adiciona 10 dias ao carimbo de data/hora especificado:

addDays('2018-03-15T13:00:00Z', 10)

E retorna este resultado: "2018-03-25T00:00:0000000Z"

Exemplo 2

Este exemplo subtrai cinco dias do carimbo de data/hora especificado:

addDays('2018-03-15T00:00:00Z', -5)

E retorna este resultado: "2018-03-10T00:00:0000000Z"

addHours

Adicione um número de horas a um carimbo de data/hora.

addHours('<timestamp>', <hours>, '<format>'?)

Exemplo 1

Este exemplo adiciona 10 horas ao carimbo de data/hora especificado:

addHours('2018-03-15T00:00:00Z', 10)

E retorna este resultado: "2018-03-15T10:00:0000000Z"

Exemplo 2

Este exemplo subtrai cinco horas do carimbo de data/hora especificado:

addHours('2018-03-15T15:00:00Z', -5)

E retorna este resultado: "2018-03-15T10:00:0000000Z"

addMinutes

Adicione um número de minutos a um carimbo de data/hora.

addMinutes('<timestamp>', <minutes>, '<format>'?)

Exemplo 1

Este exemplo adiciona 10 minutos ao carimbo de data/hora especificado:

addMinutes('2018-03-15T00:10:00Z', 10)

E retorna este resultado: "2018-03-15T00:20:00.0000000Z"

Exemplo 2

Este exemplo subtrai cinco minutos do carimbo de data/hora especificado:

addMinutes('2018-03-15T00:20:00Z', -5)

E retorna este resultado: "2018-03-15T00:15:00.0000000Z"

addSeconds

Adicione um número de segundos a um carimbo de data/hora.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Exemplo 1

Este exemplo adiciona 10 segundos ao carimbo de data/hora especificado:

addSeconds('2018-03-15T00:00:00Z', 10)

E retorna este resultado: "2018-03-15T00:00:10.0000000Z"

Exemplo 2

Este exemplo subtrai cinco segundos para o carimbo de data/hora especificado:

addSeconds('2018-03-15T00:00:30Z', -5)

E retorna este resultado: "2018-03-15T00:00:25.0000000Z"

addToTime

Adicione várias unidades de tempo a um carimbo de data/hora. Consulte também getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Exemplo 1

Este exemplo adiciona um dia ao carimbo de data/hora especificado:

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

E retorna este resultado: "2018-01-02T00:00:00.0000000Z"

Exemplo 2

Este exemplo adiciona um dia ao carimbo de data/hora especificado:

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

E retorna o resultado usando o formato "D" opcional: "Tuesday, January 2, 2018"

e

Verifique se ambas as expressões são verdadeiras. Retornar true quando ambas as expressões forem verdadeiras ou retornar false quando pelo menos uma expressão for false.

and(<expression1>, <expression2>)

Exemplo 1

Estes exemplos verificam se os valores boolianos especificados são verdadeiros:

and(true, true)
and(false, true)
and(false, false)

E retorna estes resultados:

• Primeiro exemplo: ambas as expressões são verdadeiras, portanto, retorna true.
• Segundo exemplo: uma expressão é falsa, portanto, retorna false.
• Terceiro exemplo: ambas as expressões são falsas, portanto, retorna false.

Exemplo 2

Estes exemplos verificam se as expressões especificadas são verdadeiras:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

E retorna estes resultados:

• Primeiro exemplo: ambas as expressões são verdadeiras, portanto, retorna true.
• Segundo exemplo: uma expressão é falsa, portanto, retorna false.
• Terceiro exemplo: ambas as expressões são falsas, portanto, retorna false.

matriz

Retornar uma matriz de uma única entrada especificada. Para várias entradas, consulte createArray().

array('<value>')

Exemplo

Este exemplo cria uma matriz com base na cadeia de caracteres "hello":

array('hello')

E retorna este resultado: ["hello"]

base64

Retorne a versão codificada em base64 para uma cadeia de caracteres.

base64('<value>')

Exemplo

Este exemplo converte a cadeia de caracteres "hello" em uma cadeia de caracteres codificada em base64:

base64('hello')

E retorna este resultado: "aGVsbG8="

base64ToBinary

Retorne a versão binária de uma cadeia de caracteres codificada em base64.

base64ToBinary('<value>')

Exemplo

Este exemplo converte a cadeia de caracteres codificada em base64 "aGVsbG8=" em uma cadeia de caracteres binária:

base64ToBinary('aGVsbG8=')

E retorna este resultado:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64, decodificando efetivamente a cadeia de caracteres base64. Use essa função em vez de decodificarBase64(). Embora ambas as funções funcionem da mesma maneira, base64ToString() é preferível.

base64ToString('<value>')

Exemplo

Este exemplo converte a cadeia de caracteres codificada em base64 "aGVsbG8=" em apenas uma cadeia de caracteres:

base64ToString('aGVsbG8=')

E retorna este resultado: "hello"

binário

Retorne a versão binária de uma cadeia de caracteres.

binary('<value>')

Exemplo

Este exemplo converte a cadeia de caracteres "hello" em uma cadeia de caracteres binária:

binary('hello')

E retorna este resultado:

"0110100001100101011011000110110001101111"

bool

Retorne a versão booliana para um valor.

bool(<value>)

Exemplo

Estes exemplos convertem os valores especificados em valores boolianos:

bool(1)
bool(0)

E retorna estes resultados:

• Primeiro exemplo: true
• Segundo exemplo: false

unir

Retorne o primeiro valor não nulo de um ou mais parâmetros. Cadeias de caracteres vazias, matrizes vazias e objetos vazios não são nulos.

coalesce(<object_1>, <object_2>, ...)

Exemplo

Esses exemplos retornam o primeiro valor não nulo dos valores especificados ou nulo quando todos os valores são nulos:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

E retorna estes resultados:

• Primeiro exemplo: true
• Segundo exemplo: "hello"
• Terceiro exemplo: null

concat

Combine duas ou mais cadeias de caracteres e retorne a cadeia de caracteres combinada.

concat('<text1>', '<text2>', ...)

Exemplo

Este exemplo combina as cadeias de caracteres "Hello" e "World":

concat('Hello', 'World')

E retorna este resultado: "HelloWorld"

contains

Verifique se uma coleção tem um item específico. Retornar true quando o item for encontrado ou retornar false quando não for encontrado. Essa função diferencia maiúsculas de minúsculas.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Especificamente, essa função funciona nesses tipos de coleção:

• Uma cadeia de caracteres para localizar uma subcadeia de caracteres
• Uma matriz para localizar um valor
• Um dicionário para localizar uma chave

Exemplo 1

Este exemplo verifica a cadeia de caracteres "olá, mundo" para a subcadeia de caracteres "world" e retorna true:

contains('hello world', 'world')

Exemplo 2

Este exemplo verifica a cadeia de caracteres "olá, mundo" para a subcadeia de caracteres "universo" e retorna false:

contains('hello world', 'universe')

convertFromUtc

Converta um carimbo de data/hora do UTC (Universal Time Coordinated) para o fuso horário de destino.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Exemplo 1

Este exemplo converte um carimbo de data/hora no fuso horário especificado:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

E retorna este resultado: "2018-01-01T00:00:00Z"

Exemplo 2

Este exemplo converte um carimbo de data/hora no fuso horário e formato especificados:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

E retorna este resultado: "Monday, January 1, 2018"

convertTimeZone

Converta um carimbo de data/hora do fuso horário de origem para o fuso horário de destino.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Exemplo 1

Este exemplo converte o fuso horário de origem no fuso horário de destino:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

E retorna este resultado: "2018-01-01T00:00:00.0000000"

Exemplo 2

Este exemplo converte um fuso horário para o fuso horário e o formato especificados:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

E retorna este resultado: "Monday, January 1, 2018"

convertToUtc

Converter um carimbo de data/hora do fuso horário de origem em UTC (Universal Time Coordinated).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Exemplo 1

Este exemplo converte um carimbo de data/hora em UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

E retorna este resultado: "2018-01-01T08:00:00.0000000Z"

Exemplo 2

Este exemplo converte um carimbo de data/hora em UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

E retorna este resultado: "Monday, January 1, 2018"

createArray

Retornar uma matriz de várias entradas. Para matrizes de entrada única, consulte array().

createArray('<object1>', '<object2>', ...)

Exemplo

Este exemplo cria uma matriz a partir dessas entradas:

createArray('h', 'e', 'l', 'l', 'o')

E retorna este resultado: ["h", "e", "l", "l", "o"]

dataUri

Retornar um URI (identificador de recurso uniforme de dados) para uma cadeia de caracteres.

dataUri('<value>')

Exemplo

Este exemplo cria um URI de dados para a cadeia de caracteres "hello":

dataUri('hello')

E retorna este resultado: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Retorne a versão binária de um URI (identificador de recurso uniforme de dados). Use essa função em vez de decodificarDataUri(). Embora ambas as funções funcionem da mesma maneira, dataUriBinary() é preferível.

dataUriToBinary('<value>')

Exemplo

Este exemplo cria uma versão binária para este URI de dados:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E retorna este resultado:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Retorne a versão da cadeia de caracteres para um URI (identificador de recurso uniforme de dados).

dataUriToString('<value>')

Exemplo

Este exemplo cria uma cadeia de caracteres para este URI de dados:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E retorna este resultado: "hello"

dayOfMonth

Retorne o dia do mês de um carimbo de data/hora.

dayOfMonth('<timestamp>')

Exemplo

Este exemplo retorna o número do dia do mês deste carimbo de data/hora:

dayOfMonth('2018-03-15T13:27:36Z')

E retorna este resultado: 15

diaDeSemana

Retorne o dia da semana de um carimbo de data/hora.

dayOfWeek('<timestamp>')

Exemplo

Este exemplo retorna o número do dia da semana deste carimbo de data/hora:

dayOfWeek('2018-03-15T13:27:36Z')

E retorna este resultado: 3

dayOfYear

Retorne o dia do ano de um carimbo de data/hora.

dayOfYear('<timestamp>')

Exemplo

Este exemplo retorna o número do dia do ano deste carimbo de data/hora:

dayOfYear('2018-03-15T13:27:36Z')

E retorna este resultado: 74

decodeBase64

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64, decodificando efetivamente a cadeia de caracteres base64. Considere usar base64ToString() em vez de decodeBase64(). Embora ambas as funções funcionem da mesma maneira, base64ToString() é preferível.

decodeBase64('<value>')

Exemplo

Este exemplo cria uma cadeia de caracteres para uma cadeia de caracteres codificada em base64:

decodeBase64('aGVsbG8=')

E retorna este resultado: "hello"

decodeDataUri

Retorne a versão binária de um URI (identificador de recurso uniforme de dados). Considere usar dataUriToBinary(), em vez de decodeDataUri(). Embora ambas as funções funcionem da mesma maneira, dataUriToBinary() é preferível.

decodeDataUri('<value>')

Exemplo

Este exemplo retorna a versão binária para este URI de dados:

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E retorna este resultado:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Retornar uma cadeia de caracteres que substitui caracteres de escape por versões decodificadas.

decodeUriComponent('<value>')

Exemplo

Este exemplo substitui os caracteres de escape nesta cadeia de caracteres por versões decodificadas:

decodeUriComponent('http%3A%2F%2Fcontoso.com')

E retorna este resultado: "https://contoso.com"

div

Retorne o resultado inteiro da divisão de dois números. Para obter o resultado restante, consulte mod().

div(<dividend>, <divisor>)

Exemplo

Ambos os exemplos dividem o primeiro número pelo segundo número:

div(10, 5)
div(11, 5)

E retorne este resultado: 2

encodeUriComponent

Retornar uma versão codificada por URI (uniform resource identifier) para uma cadeia de caracteres substituindo caracteres não seguros de URL por caracteres de escape. Considere usar uriComponent(), em vez de encodeUriComponent(). Embora ambas as funções funcionem da mesma maneira, uriComponent() é preferível.

encodeUriComponent('<value>')

Exemplo

Este exemplo cria uma versão codificada por URI para esta cadeia de caracteres:

encodeUriComponent('https://contoso.com')

E retorna este resultado: "http%3A%2F%2Fcontoso.com"

vazio

Verifique se uma coleção está vazia. Retornar true quando a coleção estiver vazia ou retornar false quando não estiver vazia.

empty('<collection>')
empty([<collection>])

Exemplo

Estes exemplos verificam se as coleções especificadas estão vazias:

empty('')
empty('abc')

E retorna estes resultados:

• Primeiro exemplo: passa uma cadeia de caracteres vazia e, portanto, a função retorna true.
• Segundo exemplo: passa a cadeia de caracteres "abc", para que a função retorne false.

endsWith

Verifique se uma cadeia de caracteres termina com uma subcadeia de caracteres específica. Retornar true quando a subcadeia de caracteres for encontrada ou retornar false quando não for encontrada. Essa função não diferencia maiúsculas de minúsculas.

endsWith('<text>', '<searchText>')

Exemplo 1

Este exemplo verifica se a cadeia de caracteres "hello world" termina com a cadeia de caracteres "world":

endsWith('hello world', 'world')

E retorna este resultado: true

Exemplo 2

Este exemplo verifica se a cadeia de caracteres "hello world" termina com a cadeia de caracteres "universo":

endsWith('hello world', 'universe')

E retorna este resultado: false

igual

Verifique se ambos os valores, expressões ou objetos são equivalentes. Retornar true quando ambos forem equivalentes ou retornar false quando não forem equivalentes.

equals('<object1>', '<object2>')

Exemplo

Estes exemplos verificam se as entradas especificadas são equivalentes.

equals(true, 1)
equals('abc', 'abcd')

E retorna estes resultados:

• Primeiro exemplo: ambos os valores são equivalentes, portanto, a função retorna true.
• Segundo exemplo: ambos os valores não são equivalentes, portanto, a função retorna false.

primeiro

Retorne o primeiro item de uma cadeia de caracteres ou matriz.

first('<collection>')
first([<collection>])

Exemplo

Estes exemplos encontram o primeiro item nestas coleções:

first('hello')
first(createArray(0, 1, 2))

E retorne estes resultados:

• Primeiro exemplo: "h"
• Segundo exemplo: 0

derivar

Converta uma versão de cadeia de caracteres para um número de ponto flutuante em um número de ponto flutuante real.

float('<value>')

Exemplo

Este exemplo cria uma versão de cadeia de caracteres para este número de ponto flutuante:

float('10.333')

E retorna este resultado: 10.333

formatDateTime

Retornar um carimbo de data/hora no formato especificado.

formatDateTime('<timestamp>', '<format>'?)

Exemplo

Este exemplo converte um carimbo de data/hora no formato especificado:

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

E retorna este resultado: "2018-03-15T12:00:00"

getFutureTime

Retorne o carimbo de data/hora atual mais as unidades de tempo especificadas.

getFutureTime(<interval>, <timeUnit>, <format>?)

Exemplo 1

Suponha que o carimbo de data/hora atual seja "2018-03-01T00:00:00.0000000Z". Este exemplo adiciona cinco dias a esse carimbo de data/hora:

getFutureTime(5, 'Day')

E retorna este resultado: "2018-03-06T00:00:00.0000000Z"

Exemplo 2

Suponha que o carimbo de data/hora atual seja "2018-03-01T00:00:00.0000000Z". Este exemplo adiciona cinco dias e converte o resultado em formato "D":

getFutureTime(5, 'Day', 'D')

E retorna este resultado: "Tuesday, March 6, 2018"

getPastTime

Retorne o carimbo de data/hora atual menos as unidades de tempo especificadas.

getPastTime(<interval>, <timeUnit>, <format>?)

Exemplo 1

Suponha que o carimbo de data/hora atual seja "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias desse carimbo de data/hora:

getPastTime(5, 'Day')

E retorna este resultado: "2018-01-27T00:00:00.0000000Z"

Exemplo 2

Suponha que o carimbo de data/hora atual seja "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias e converte o resultado em formato "D":

getPastTime(5, 'Day', 'D')

E retorna este resultado: "Saturday, January 27, 2018"

maior

Verifique se o primeiro valor é maior que o segundo valor. Retornar true quando o primeiro valor for mais ou retornar false quando menor.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Exemplo

Estes exemplos verificam se o primeiro valor é maior que o segundo valor:

greater(10, 5)
greater('apple', 'banana')

E retorne estes resultados:

• Primeiro exemplo: true
• Segundo exemplo: false

greaterOrEquals

Verifique se o primeiro valor é maior ou igual ao segundo valor. Retornar true quando o primeiro valor for maior ou igual ou retornar false quando o primeiro valor for menor.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Exemplo

Estes exemplos verificam se o primeiro valor é maior ou igual ao segundo valor:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

E retorne estes resultados:

• Primeiro exemplo: true
• Segundo exemplo: false

guid

Gere um GUID (identificador global exclusivo) como uma cadeia de caracteres, por exemplo, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Além disso, você pode especificar um formato diferente para o GUID que não seja o formato padrão, "D", que é 32 dígitos separados por hifens.

guid('<format>')

Exemplo

Este exemplo gera o mesmo GUID, mas como 32 dígitos, separados por hifens e entre parênteses:

guid('P')

E retorna este resultado: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Verifique se uma expressão é verdadeira ou falsa. Com base no resultado, retorne um valor especificado.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Exemplo

Este exemplo retorna "yes" porque a expressão especificada retorna true. Caso contrário, o exemplo retornará "no":

if(equals(1, 1), 'yes', 'no')

indexOf

Retorne a posição inicial ou o valor do índice para uma subcadeia de caracteres. Essa função não diferencia maiúsculas de minúsculas e os índices começam com o número 0.

indexOf('<text>', '<searchText>')

Exemplo

Este exemplo localiza o valor de índice inicial para a subcadeia de caracteres "world" na cadeia de caracteres "hello world":

indexOf('hello world', 'world')

E retorna este resultado: 6

int

Retorne a versão inteiro de uma cadeia de caracteres.

int('<value>')

Exemplo

Este exemplo cria uma versão de inteiro para a cadeia de caracteres "10":

int('10')

E retorna este resultado: 10

json

Retorne o valor ou objeto do tipo JSON (JavaScript Object Notation) para uma cadeia de caracteres ou XML.

json('<value>')

Exemplo 1

Este exemplo converte essa cadeia de caracteres no valor JSON:

json('[1, 2, 3]')

E retorna este resultado: [1, 2, 3]

Exemplo 2

Este exemplo converte essa cadeia de caracteres em JSON:

json('{"fullName": "Sophia Owen"}')

E retorna este resultado:

{
  "fullName": "Sophia Owen"
}

Exemplo 3

Este exemplo converte este XML em JSON:

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

E retorna este resultado:

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

cruzamento

Retornar uma coleção que tenha apenas os itens comuns entre as coleções especificadas. Para aparecer no resultado, um item deve aparecer em todas as coleções passadas para essa função. Se um ou mais itens tiverem o mesmo nome, o último item com esse nome será exibido no resultado.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Exemplo

Este exemplo localiza os itens comuns entre estas matrizes:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

E retorna uma matriz com apenas estes itens: [1, 2]

ingressar

Retornar uma cadeia de caracteres que tem todos os itens de uma matriz e tem cada caractere separado por um delimitador.

join([<collection>], '<delimiter>')

Exemplo

Este exemplo cria uma cadeia de caracteres de todos os itens nesta matriz com o caractere especificado como delimitador:

join(createArray('a', 'b', 'c'), '.')

E retorna este resultado: "a.b.c"

último

Retorne o último item de uma coleção.

last('<collection>')
last([<collection>])

Exemplo

Estes exemplos encontram o último item nestas coleções:

last('abcd')
last(createArray(0, 1, 2, 3))

E retorna estes resultados:

• Primeiro exemplo: "d"
• Segundo exemplo: 3

lastIndexOf

Retorne a posição inicial ou o valor do índice para a última ocorrência de uma subcadeia de caracteres. Essa função não diferencia maiúsculas de minúsculas e os índices começam com o número 0.

lastIndexOf('<text>', '<searchText>')

Exemplo

Este exemplo localiza o valor do índice inicial para a última ocorrência da subcadeia de caracteres "world" na cadeia de caracteres "hello world":

lastIndexOf('hello world', 'world')

E retorna este resultado: 6

length

Retorne o número de itens em uma coleção.

length('<collection>')
length([<collection>])

Exemplo

Estes exemplos contam o número de itens nestas coleções:

length('abcd')
length(createArray(0, 1, 2, 3))

E retorne este resultado: 4

menos

Verifique se o primeiro valor é menor que o segundo valor. Retornar true quando o primeiro valor for menor ou retornar false quando o primeiro valor for maior.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Exemplo

Esses exemplos verificam se o primeiro valor é menor que o segundo valor.

less(5, 10)
less('banana', 'apple')

E retorne estes resultados:

• Primeiro exemplo: true
• Segundo exemplo: false

lessOrEquals

Verifique se o primeiro valor é menor ou igual ao segundo valor. Retornar true quando o primeiro valor for menor ou igual ou retornar false quando o primeiro valor for maior.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Exemplo

Esses exemplos verificam se o primeiro valor é menor ou igual ao segundo valor.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

E retorne estes resultados:

• Primeiro exemplo: true
• Segundo exemplo: false

max

Retorne o valor mais alto de uma lista ou matriz com números inclusivos em ambas as extremidades.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Exemplo

Estes exemplos obtêm o valor mais alto do conjunto de números e da matriz:

max(1, 2, 3)
max(createArray(1, 2, 3))

E retorne este resultado: 3

min

Retorne o valor mais baixo de um conjunto de números ou de uma matriz.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Exemplo

Estes exemplos obtêm o valor mais baixo no conjunto de números e na matriz:

min(1, 2, 3)
min(createArray(1, 2, 3))

E retorne este resultado: 1

mod

Retorne o restante da divisão de dois números. Para obter o resultado inteiro, consulte div().

mod(<dividend>, <divisor>)

Exemplo

Este exemplo divide o primeiro número pelo segundo número:

mod(3, 2)

E retorne este resultado: 1

mul

Retorne o produto da multiplicação de dois números.

mul(<multiplicand1>, <multiplicand2>)

Exemplo

Estes exemplos múltiplos do primeiro número pelo segundo número:

mul(1, 2)
mul(1.5, 2)

E retorne estes resultados:

• Primeiro exemplo: 2
• Segundo exemplo 3

not

Verifique se uma expressão é falsa. Retornar true quando a expressão for false ou retornar false quando true.

not(<expression>)

Exemplo 1

Estes exemplos verificam se as expressões especificadas são falsas:

not(false)
not(true)

E retorne estes resultados:

• Primeiro exemplo: a expressão é falsa, portanto, a função retorna true.
• Segundo exemplo: a expressão é verdadeira, portanto, a função retorna false.

Exemplo 2

Estes exemplos verificam se as expressões especificadas são falsas:

not(equals(1, 2))
not(equals(1, 1))

E retorne estes resultados:

• Primeiro exemplo: a expressão é falsa, portanto, a função retorna true.
• Segundo exemplo: a expressão é verdadeira, portanto, a função retorna false.

or

Verifique se pelo menos uma expressão é verdadeira. Retornar true quando pelo menos uma expressão for verdadeira ou retornar false quando ambas forem falsas.

or(<expression1>, <expression2>)

Exemplo 1

Estes exemplos verificam se pelo menos uma expressão é verdadeira:

or(true, false)
or(false, false)

E retorne estes resultados:

• Primeiro exemplo: pelo menos uma expressão é verdadeira, portanto, a função retorna true.
• Segundo exemplo: ambas as expressões são falsas, portanto, a função retorna false.

Exemplo 2

Estes exemplos verificam se pelo menos uma expressão é verdadeira:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

E retorne estes resultados:

• Primeiro exemplo: pelo menos uma expressão é verdadeira, portanto, a função retorna true.
• Segundo exemplo: ambas as expressões são falsas, portanto, a função retorna false.

rand

Retornar um inteiro aleatório de um intervalo especificado, que é inclusivo apenas no final inicial.

rand(<minValue>, <maxValue>)

Exemplo

Este exemplo obtém um inteiro aleatório do intervalo especificado, excluindo o valor máximo:

rand(1, 5)

E retorna um desses números como resultado: 1, , 2, 3ou 4

alcance

Retornar uma matriz de inteiros que começa de um inteiro especificado.

range(<startIndex>, <count>)

Exemplo

Este exemplo cria uma matriz de inteiros que começa a partir do índice especificado e tem o número especificado de inteiros:

range(1, 4)

E retorna este resultado: [1, 2, 3, 4]

substituir

Substitua uma subcadeia de caracteres pela cadeia de caracteres especificada e retorne a cadeia de caracteres de resultado. Essa função diferencia maiúsculas de minúsculas.

replace('<text>', '<oldText>', '<newText>')

Exemplo

Este exemplo localiza a subcadeia de caracteres "antiga" na "cadeia de caracteres antiga" e substitui "old" por "new":

replace('the old string', 'old', 'new')

E retorna este resultado: "the new string"

ignorar

Remova os itens da frente de uma coleção e retorne todos os outros itens.

skip([<collection>], <count>)

Exemplo

Este exemplo remove um item, o número 0, da frente da matriz especificada:

skip(createArray(0, 1, 2, 3), 1)

E retorna essa matriz com os itens restantes: [1,2,3]

dividir

Retornar uma matriz que contém subcadeias de caracteres, separadas por vírgulas, com base no caractere delimitador especificado na cadeia de caracteres original.

split('<text>', '<delimiter>')

Exemplo

Este exemplo cria uma matriz com subcadeias de caracteres da cadeia de caracteres especificada com base no caractere especificado como delimitador:

split('a_b_c', '_')

E retorna essa matriz como resultado: ["a","b","c"]

startOfDay

Retorne o início do dia para um carimbo de data/hora.

startOfDay('<timestamp>', '<format>'?)

Exemplo

Este exemplo localiza o início do dia para este carimbo de data/hora:

startOfDay('2018-03-15T13:30:30Z')

E retorna este resultado: "2018-03-15T00:00:00.0000000Z"

startOfHour

Retorne o início da hora para um carimbo de data/hora.

startOfHour('<timestamp>', '<format>'?)

Exemplo

Este exemplo localiza o início da hora deste carimbo de data/hora:

startOfHour('2018-03-15T13:30:30Z')

E retorna este resultado: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Retorne o início do mês para um carimbo de data/hora.

startOfMonth('<timestamp>', '<format>'?)

Exemplo

Este exemplo retorna o início do mês para este carimbo de data/hora:

startOfMonth('2018-03-15T13:30:30Z')

E retorna este resultado: "2018-03-01T00:00:00.0000000Z"

startsWith

Verifique se uma cadeia de caracteres começa com uma subcadeia de caracteres específica. Retornar true quando a subcadeia de caracteres for encontrada ou retornar false quando não for encontrada. Essa função não diferencia maiúsculas de minúsculas.

startsWith('<text>', '<searchText>')

Exemplo 1

Este exemplo verifica se a cadeia de caracteres "hello world" começa com a subcadeia de caracteres "hello":

startsWith('hello world', 'hello')

E retorna este resultado: true

Exemplo 2

Este exemplo verifica se a cadeia de caracteres "olá, mundo" começa com a subcadeia de caracteres "saudações":

startsWith('hello world', 'greetings')

E retorna este resultado: false

cadeia

Retorne a versão da cadeia de caracteres para um valor.

string(<value>)

Exemplo 1

Este exemplo cria a versão da cadeia de caracteres para este número:

string(10)

E retorna este resultado: "10"

Exemplo 2

Este exemplo cria uma cadeia de caracteres para o objeto JSON especificado e usa o caractere de barra invertida (\) como um caractere de escape para a aspa dupla (").

string( { "name": "Sophie Owen" } )

E retorna este resultado: "{ \\"name\\": \\"Sophie Owen\\" }"

Substituto

Retorne o resultado da subtração do segundo número do primeiro número.

sub(<minuend>, <subtrahend>)

Exemplo

Este exemplo subtrai o segundo número do primeiro número:

sub(10.3, .3)

E retorna este resultado: 10

substring

Retornar caracteres de uma cadeia de caracteres, começando da posição especificada ou do índice. Os valores de índice começam com o número 0.

substring('<text>', <startIndex>, <length>)

Exemplo

Este exemplo cria uma subcadeia de caracteres de cinco caracteres da cadeia de caracteres especificada, começando pelo valor de índice 6:

substring('hello world', 6, 5)

E retorna este resultado: "world"

subtractFromTime

Subtraia várias unidades de tempo de um carimbo de data/hora. Consulte também getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Exemplo 1

Este exemplo subtrai um dia deste carimbo de data/hora:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

E retorna este resultado: "2018-01-01T00:00:00:0000000Z"

Exemplo 2

Este exemplo subtrai um dia deste carimbo de data/hora:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

E retorna esse resultado usando o formato "D" opcional: "Monday, January, 1, 2018"

tomar

Retornar itens da frente de uma coleção.

take('<collection>', <count>)
take([<collection>], <count>)

Exemplo

Estes exemplos obtêm o número especificado de itens da frente dessas coleções:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

E retorne estes resultados:

• Primeiro exemplo: "abc"
• Segundo exemplo: [0, 1, 2]

Carrapatos

Retorne o valor da ticks propriedade para um carimbo de data/hora especificado. Um tique é um intervalo de 100 nanossegundos.

ticks('<timestamp>')

toLower

Retornar uma cadeia de caracteres em formato minúsculo. Se um caractere na cadeia de caracteres não tiver uma versão minúscula, esse caractere permanecerá inalterado na cadeia de caracteres retornada.

toLower('<text>')

Exemplo

Este exemplo converte essa cadeia de caracteres em letras minúsculas:

toLower('Hello World')

E retorna este resultado: "hello world"

toUpper

Retornar uma cadeia de caracteres em formato maiúsculo. Se um caractere na cadeia de caracteres não tiver uma versão maiúscula, esse caractere permanecerá inalterado na cadeia de caracteres retornada.

toUpper('<text>')

Exemplo

Este exemplo converte essa cadeia de caracteres em maiúsculas:

toUpper('Hello World')

E retorna este resultado: "HELLO WORLD"

cortar

Remova o espaço em branco à esquerda e à direita de uma cadeia de caracteres e retorne a cadeia de caracteres atualizada.

trim('<text>')

Exemplo

Este exemplo remove o espaço em branco à esquerda e à direita da cadeia de caracteres " Olá, Mundo ":

trim(' Hello World  ')

E retorna este resultado: "Hello World"

união

Retornar uma coleção que tenha todos os itens das coleções especificadas. Para aparecer no resultado, um item pode aparecer em qualquer coleção passada para essa função. Se um ou mais itens tiverem o mesmo nome, o último item com esse nome será exibido no resultado.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Exemplo

Este exemplo obtém todos os itens dessas coleções:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

E retorna este resultado: [1, 2, 3, 10, 101]

uriComponent

Retornar uma versão codificada por URI (uniform resource identifier) para uma cadeia de caracteres substituindo caracteres não seguros de URL por caracteres de escape. Use essa função em vez de codificarUriComponent(). Embora ambas as funções funcionem da mesma maneira, uriComponent() é preferível.

uriComponent('<value>')

Exemplo

Este exemplo cria uma versão codificada por URI para esta cadeia de caracteres:

uriComponent('https://contoso.com')

E retorna este resultado: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Retorne a versão binária de um componente de URI (uniform resource identifier).

uriComponentToBinary('<value>')

Exemplo

Este exemplo cria a versão binária para esta cadeia de caracteres codificada por URI:

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

E retorna este resultado:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada por URI (uniform resource identifier), decodificando efetivamente a cadeia de caracteres codificada por URI.

uriComponentToString('<value>')

Exemplo

Este exemplo cria a versão de cadeia de caracteres decodificada para esta cadeia de caracteres codificada por URI:

uriComponentToString('http%3A%2F%2Fcontoso.com')

E retorna este resultado: "https://contoso.com"

utcNow

Retorne o carimbo de data/hora atual.

utcNow('<format>')

Opcionalmente, você pode especificar um formato diferente com o parâmetro de <formato> .

Exemplo 1

Suponha que hoje seja 15 de abril de 2018 às 13:00 pm. Este exemplo obtém o carimbo de data/hora atual:

utcNow()

E retorna este resultado: "2018-04-15T13:00:00.0000000Z"

Exemplo 2

Suponha que hoje seja 15 de abril de 2018 às 13:00 pm. Este exemplo obtém o carimbo de data/hora atual usando o formato opcional "D":

utcNow('D')

E retorna este resultado: "Sunday, April 15, 2018"

Xml

Retorne a versão XML de uma cadeia de caracteres que contém um objeto JSON.

xml('<value>')

Exemplo 1

Este exemplo cria a versão XML para esta cadeia de caracteres, que contém um objeto JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

E retorna este XML de resultado:

<name>Sophia Owen</name>

Exemplo 2

Suponha que você tenha este objeto JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Este exemplo cria XML para uma cadeia de caracteres que contém este objeto JSON:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

E retorna este XML de resultado:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xpath

Verifique XML em busca de nós ou valores que correspondam a uma expressão XPath (Linguagem de Caminho XML) e retorne os nós ou valores correspondentes. Uma expressão XPath ou apenas "XPath" ajuda você a navegar por uma estrutura de documentos XML para que você possa selecionar nós ou valores de computação no conteúdo XML.

xpath('<xml>', '<xpath>')

Exemplo 1

Seguindo o Exemplo 1, este exemplo localiza nós que correspondem ao <count></count> nó e adiciona esses valores de nó com a sum() função:

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

E retorna este resultado: 30

Exemplo 2

Para este exemplo, ambas as expressões encontram nós que correspondem ao <location></location> nó, nos argumentos especificados, que incluem XML com um namespace. As expressões usam o caractere de barra invertida (\) como um caractere de escape para a aspa dupla (").

• Expressão 1

  xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

• Expressão 2

  xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

Aqui estão os argumentos:

• Este XML, que inclui o namespace do documento XML, xmlns="http://contoso.com":

  <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
  

• Qualquer expressão XPath aqui:

  • /*[name()=\"file\"]/*[name()=\"location\"]

  • /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Este é o nó de resultado que corresponde ao <location></location> nó:

<location xmlns="https://contoso.com">Paris</location>

Exemplo 3

Seguindo o Exemplo 3, este exemplo localiza o valor no <location></location> nó:

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

E retorna este resultado: "Paris"

Conteúdo relacionado

Para obter instruções sobre o uso geral de parâmetros, consulte Parâmetros para Data Factory no Fabric