Выражения и функции фабрики данных в Microsoft Fabric

В этой статье содержатся сведения о выражениях и функциях, поддерживаемых фабрикой данных в Microsoft Fabric.

Выражения

Значения выражений в определении могут быть литеральными или выражениями, которые вычисляются во время выполнения. Например:

"value"

или

"@pipeline().parameters.password"

Выражения могут отображаться в любом месте строкового значения и всегда приводят к другому строковому значению. Если значение является выражением, текст выражения извлекается путем удаления знака (@). Если требуется литеральная строка, которая начинается с @, ее следует экранировать с помощью @@. В следующих примерах показано, как вычисляются выражения.

Выражения также могут отображаться внутри строк, используя функцию интерполяции строк, где выражения упаковываются в @{ ... }. Например, "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

С помощью интерполяции строк результат всегда является строкой. Скажем, я определил myNumber как 42 и myString как foo:

В действиях потока управления, таких как действие ForEach, можно указать массив для итерации элементов свойств и использовать @item() для итерации по одному перечислению в действии ForEach. Например, если элементы являются массивом: [1, 2, 3], @item() возвращает 1 в первой итерации, 2 во второй итерации и 3 в третьей итерации. Можно также использовать выражение как @range(0,10) для итерации 10 раз, начиная с 0 и заканчивая на 9.

Вы можете использовать @activity("имя действия" для записи выходных данных действия и принятия решений. Рассмотрим веб-действие с именем Web1. Для размещения выходных данных первого действия во втором тексте выражение обычно выглядит следующим образом: @activity("Web1".output или @activity("Web1".output.data или что-то подобное в зависимости от того, как выглядит результат первого действия.

Примеры

Пример сложного выражения

В приведенном ниже примере показан сложный пример, ссылающийся на глубокое подполе результатов деятельности. Чтобы ссылаться на параметр конвейера, который оценивается как подполе, используйте синтаксис [] вместо оператора точка (.), как в случае подполе1 и подполе2, в рамках результатов выполнения действия.

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

Динамическое создание файлов и их именование является общим шаблоном. Рассмотрим несколько примеров именования динамических файлов.

• Добавление даты к имени файла: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
• Добавление даты и времени в часовом поясе клиента: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
• Время триггера добавления: @concat('Test_', pipeline().TriggerTime)
• Выводит пользовательское имя файла в потоке данных сопоставления при выводе в один файл с датой: 'Test_' + toString(currentDate()) + '.csv'

В приведенных выше случаях создаются четыре динамических имени файла, начиная с Test_.

Редактор динамического содержимого

Редактор динамического содержимого автоматически экранирует символы в вашем содержимом после завершения редактирования. Например, следующее содержимое в редакторе содержимого — это интерполяция строк с функцией выражения.

"@{toUpper('myData')}"

Редактор динамического содержимого преобразует выше содержимое в выражение "@{toUpper('myData')}". Результатом этого выражения является отформатированная строка, показанная ниже.

"MYDATA"

Замена специальных символов

Редактор динамического содержимого автоматически экранирует такие символы, как двойные кавычки и обратная косая черта, в вашем содержимом после окончания редактирования. Это приводит к проблемам, если вы хотите заменить перевод строки или знак табуляции с помощью \n, \t в функции replace(). Динамическое содержимое можно изменить в представлении кода, чтобы удалить дополнительные \ в выражении, или выполнить следующие действия, чтобы заменить специальные символы с помощью языка выражений:

1. Кодировка URL-адреса в отношении исходного строкового значения
2. Замените строку, закодированную URL-адресом, например, перевод строки (%0A), возврат каретки (%0D), горизонтальная табуляция (%09).
3. Декодирование URL-адресов

Например, переменная companyName с символом новой строки в её значении, выражение @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) может удалить символ новой строки.

Contoso- Corporation

Экранирование одиночного символа кавычки

Функции выражений используют одинарную кавычку для строковых параметров. Используйте две одинарные кавычки, чтобы экранировать символ ' в строковых функциях. Например, выражение @concat('Baba', '''s ', 'book store') возвращает следующий результат.

Baba's book store

Переменные области конвейера

Эти системные переменные можно использовать в любом месте процесса.

Функции

Функции можно вызывать в выражениях. В следующих разделах содержатся сведения о функциях, которые можно использовать в выражении.

Функции даты

Строковые функции

Для работы со строками можно использовать эти строковые функции, а также функции некоторых коллекций. Строковые функции работают только на строках.

Функции коллекции

Для работы с коллекциями, как правило, массивами, строками и иногда словарями можно использовать эти функции коллекции.

Логические функции

Эти функции полезны в условиях, их можно использовать для оценки любого типа логики.

Функции преобразования

Эти функции используются для преобразования между каждым из собственных типов на языке:

• струна
• целое число
• плавать
• булев
• Массивы
• Словари

Математические функции

Эти функции можно использовать для любого из двух типов чисел: целых чисел и вещественных чисел.

Справочник по функциям

В этом разделе перечислены все доступные функции в алфавитном порядке.

добавлять

Возвращает результат сложения двух чисел.

add(<summand_1>, <summand_2>)

пример

В этом примере добавляются указанные числа:

add(1, 1.5)

И возвращает этот результат: 2.5

addDays

Добавьте несколько дней в метку времени.

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

пример 1

В этом примере до указанной метки времени добавляется 10 дней:

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

И возвращает этот результат: "2018-03-25T00:00:0000000Z"

пример 2

В этом примере вычитается пять дней из указанной метки времени:

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

И возвращает этот результат: "2018-03-10T00:00:0000000Z"

добавить часы

Добавьте несколько часов в метку времени.

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

пример 1

В этом примере до указанной метки времени добавляется 10 часов:

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

И возвращает этот результат: "2018-03-15T10:00:0000000Z"

пример 2

В этом примере вычитается пять часов из указанной метки времени:

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

И возвращает этот результат: "2018-03-15T10:00:0000000Z"

добавить минуты

Добавьте несколько минут в метку времени.

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

пример 1

В этом примере до указанной метки времени добавляется 10 минут:

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

И возвращает этот результат: "2018-03-15T00:20:00.0000000Z"

пример 2

В этом примере вычитается пять минут из указанной метки времени:

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

И возвращает этот результат: "2018-03-15T00:15:00.0000000Z"

добавлениеСекунд

Добавьте количество секунд в метку времени.

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

пример 1

В этом примере добавляется 10 секунд к указанной метке времени:

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

И возвращает этот результат: "2018-03-15T00:00:10.0000000Z"

пример 2

В этом примере вычитаем пять секунд от указанной временной метки.

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

И возвращает этот результат: "2018-03-15T00:00:25.0000000Z"

addToTime

Добавьте несколько единиц времени в метку времени. См. также getFutureTime().

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

пример 1

В этом примере добавляется один день к указанной метке времени:

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

И возвращает этот результат: "2018-01-02T00:00:00.0000000Z"

пример 2

В этом примере добавляется один день к указанной метке времени:

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

И возвращает результат с помощью необязательного формата D: "Tuesday, January 2, 2018"

и

Проверьте, являются ли оба выражения истинными. Возвращает значение true, если оба выражения истинны, или возвращает значение false, если хотя бы одно выражение ложно.

and(<expression1>, <expression2>)

пример 1

В этих примерах проверяется, являются ли указанные логические значения верными:

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

И возвращает следующие результаты:

• Первый пример: оба выражения являются истинными, поэтому возвращает true.
• Второй пример: одно выражение равно false, поэтому возвращается false.
• Третий пример: оба выражения имеют значение false, поэтому возвращается false.

пример 2

В этих примерах проверяется, являются ли указанные выражения верными:

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

И возвращает следующие результаты:

• Первый пример: оба выражения являются истинными, поэтому возвращает true.
• Второй пример: одно выражение ложно, поэтому возвращается false.
• Третий пример: оба выражения имеют значение false, поэтому возвращается false.

массив

Возвращает массив из одного указанного входного значения. Сведения о нескольких входных данных см. в createArray().

array('<value>')

пример

В этом примере создается массив из строки hello:

array('hello')

И возвращает этот результат: ["hello"]

base64

Возвращает версию в кодировке Base64 для строки.

base64('<value>')

пример

В этом примере строка hello преобразуется в строку в кодировке Base64:

base64('hello')

И возвращает этот результат: "aGVsbG8="

base64ToBinary

Возвращает двоичную версию для строки в кодировке Base64.

base64ToBinary('<value>')

пример

В этом примере кодированная строка Base64 преобразуется в двоичную строку.

base64ToBinary('aGVsbG8=')

И возвращает следующий результат:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Возвращает строковую версию для строки в кодировке Base64, эффективно декодируя строку base64. Используйте эту функцию, а не декодированиеBase64(). Хотя обе функции работают одинаково, base64ToString() предпочтительнее.

base64ToString('<value>')

пример

В этом примере строка, закодированная в Base64, преобразуется в обычную строку.

base64ToString('aGVsbG8=')

И возвращает этот результат: "hello"

двоичный

Возвращает двоичную версию для строки.

binary('<value>')

пример

В этом примере строка hello преобразуется в двоичную строку:

binary('hello')

И возвращает следующий результат:

"0110100001100101011011000110110001101111"

bool

Возвращает логическое представление значения.

bool(<value>)

пример

В этих примерах значения преобразуются в логические значения:

bool(1)
bool(0)

И возвращает следующие результаты:

• Первый пример: true
• Второй пример: false

срастаться

Возвращает первое значение, отличное от NULL, из одного или нескольких параметров. Пустые строки, пустые массивы и пустые объекты не являются null.

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

пример

В этих примерах возвращается первое непустое значение из указанных значений или значение NULL, если все значения имеют значение NULL:

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

И возвращает следующие результаты:

• Первый пример: true
• Второй пример: "hello"
• Третий пример: null

concat

Объедините две или несколько строк и верните объединенную строку.

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

пример

В этом примере объединяются строки Hello и World:

concat('Hello', 'World')

И возвращает этот результат: "HelloWorld"

Содержит

Проверьте, имеет ли коллекция определенный элемент. Возвращает значение true при обнаружении элемента или возвращает значение false, если он не найден. Эта функция учитывает регистр.

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

В частности, эта функция работает с этими типами коллекций:

• Строка для поиска подстроки
• Массив для поиска значения
• Словарь для поиска ключа

пример 1

В этом примере выполняется проверка строки hello world для подстроки "world" и возвращает значение true:

contains('hello world', 'world')

пример 2

В этом примере проверяется строка hello world для подстроки "вселенная" и возвращает значение false:

contains('hello world', 'universe')

конвертировать из UTC

Преобразуйте метку времени из универсального часового пояса (UTC) в целевой часовой пояс.

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

пример 1

В этом примере метка времени преобразуется в указанный часовой пояс:

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

И возвращает этот результат: "2018-01-01T00:00:00Z"

пример 2

В этом примере метка времени преобразуется в указанный часовой пояс и формат:

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

И возвращает этот результат: "Monday, January 1, 2018"

convertTimeZone

Преобразуйте метку времени из исходного часового пояса в целевой часовой пояс.

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

пример 1

В этом примере исходный часовой пояс преобразуется в целевой часовой пояс:

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

И возвращает этот результат: "2018-01-01T00:00:00.0000000"

пример 2

В этом примере часовой пояс преобразуется в указанный часовой пояс и формат:

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

И возвращает этот результат: "Monday, January 1, 2018"

convertToUtc

Преобразуйте метку времени из исходного часового пояса в универсальный код времени (UTC).

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

пример 1

В этом примере метка времени преобразуется в формате UTC:

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

И возвращает этот результат: "2018-01-01T08:00:00.0000000Z"

пример 2

В этом примере метка времени преобразуется в формате UTC:

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

И возвращает этот результат: "Monday, January 1, 2018"

createArray

Возвращает массив из нескольких входных данных. Для одиночных входных массивов см. в array().

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

пример

В этом примере создается массив из этих входных данных:

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

И возвращает этот результат: ["h", "e", "l", "l", "o"]

dataUri

Возвращает универсальный идентификатор ресурса (URI) данных для строки.

dataUri('<value>')

пример

В этом примере создается URI данных для строки "hello":

dataUri('hello')

И возвращает этот результат: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Верните двоичную версию для универсального указателя ресурсов (URI) для данных. Используйте эту функцию, а не decodeDataUri(). Хотя обе функции работают одинаково, dataUriBinary() предпочтительнее.

dataUriToBinary('<value>')

пример

В этом примере создается двоичная версия для этого URI данных:

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

И возвращает следующий результат:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Верните строковую версию для URI (универсального идентификатора ресурса) данных.

dataUriToString('<value>')

пример

В этом примере создается строка для этого URI данных:

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

И возвращает этот результат: "hello"

день месяца

Возвращает день месяца из метки времени.

dayOfMonth('<timestamp>')

пример

В этом примере возвращается номер дня месяца из этой временной метки.

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

И возвращает этот результат: 15

dayOfWeek

Верните день недели из метки времени.

dayOfWeek('<timestamp>')

пример

В этом примере возвращается число, соответствующее дню недели, из этого временного штампа:

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

И возвращает этот результат: 3

dayOfYear

Возвращает день года из метки времени.

dayOfYear('<timestamp>')

пример

В этом примере возвращается число дней года из этой метки времени:

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

И возвращает этот результат: 74

декодированиеBase64

Возвращает строковую версию для строки в кодировке Base64, эффективно декодируя строку base64. Рекомендуется использовать base64ToString() вместо decodeBase64(). Хотя обе функции работают одинаково, base64ToString() предпочтительнее.

decodeBase64('<value>')

пример

В этом примере создается строка для строки в кодировке Base64:

decodeBase64('aGVsbG8=')

И возвращает этот результат: "hello"

decodeDataUri

Возвращает двоичную версию для универсального идентификатора ресурса данных (URI). Рекомендуется использовать dataUriToBinary(), а не decodeDataUri(). Хотя обе функции работают одинаково, dataUriToBinary() предпочтительнее.

decodeDataUri('<value>')

пример

В этом примере возвращается двоичная версия для этого URI данных:

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

И возвращает следующий результат:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

декодированиеUriComponent

Возвращает строку, которая заменяет escape-символы декодированных версий.

decodeUriComponent('<value>')

Пример

В этом примере escape-символы в этой строке заменяются на версии в декодированном виде.

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

И возвращает этот результат: "https://contoso.com"

div

Возвращает целочисленный результат деления двух чисел. Чтобы получить оставшийся результат, см. мод().

div(<dividend>, <divisor>)

пример

Оба примера делят первое число на второй номер:

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

И верните этот результат: 2

encodeUriComponent

Возврат универсального идентификатора ресурса (URI) для строки путем замены небезопасных символов URL-адреса escape-символами. Рекомендуется использовать uriComponent(), а не encodeUriComponent(). Хотя обе функции работают одинаково, uriComponent() предпочтительнее.

encodeUriComponent('<value>')

пример

В этом примере создается версия в кодировке URI для этой строки:

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

И возвращает этот результат: "http%3A%2F%2Fcontoso.com"

пустой

Проверьте, пуста ли коллекция. Возвращает значение true, если коллекция пуста или возвращает значение false, если не пусто.

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

пример

В этих примерах проверяется, являются ли указанные коллекции пустыми:

empty('')
empty('abc')

И возвращает следующие результаты:

• Первый пример: передает пустую строку, поэтому функция возвращает true.
• Второй пример: передает строку abc, поэтому функция возвращает false.

заканчивается на

Проверьте, заканчивается ли строка определенной подстрокой. Возвращает значение true при обнаружении подстроки или возвращает значение false, если он не найден. Эта функция не учитывает регистр.

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

пример 1

В этом примере проверяется, заканчивается ли строка "hello world" строкой "world":

endsWith('hello world', 'world')

И возвращает этот результат: true

пример 2

В этом примере проверяется, заканчивается ли строка hello world строкой "вселенная":

endsWith('hello world', 'universe')

И возвращает этот результат: false

Равно

Проверьте, эквивалентны ли оба значения, выражения или объекты. Возвращает значение true, если оба значения эквивалентны или возвращают значение false, если они не эквивалентны.

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

пример

В этих примерах проверяется, эквивалентны ли указанные входные данные.

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

И возвращает следующие результаты:

• Первый пример: оба значения эквивалентны, поэтому функция возвращает true.
• Второй пример: оба значения не эквивалентны, поэтому функция возвращает false.

первый

Возвращает первый элемент из строки или массива.

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

пример

Первый элемент в данных коллекциях находится в следующих примерах:

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

И верните следующие результаты:

• Первый пример: "h"
• Второй пример: 0

плавать

Преобразуйте строковую версию для числа с плавающей запятой в фактический номер с плавающей запятой.

float('<value>')

пример

В этом примере создается строковая версия для этого числа с плавающей запятой:

float('10.333')

И возвращает этот результат: 10.333

форматироватьДатуВремя

Возвращает метку времени в указанном формате.

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

пример

В этом примере метка времени преобразуется в указанный формат:

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

И возвращает этот результат: "2018-03-15T12:00:00"

getFutureTime

Возвращает текущую метку времени и указанные единицы времени.

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

пример 1

Предположим, что текущая метка времени — "2018-03-01T00:00:0000000Z". В этом примере добавляется пять дней к этой метке времени:

getFutureTime(5, 'Day')

И возвращает этот результат: "2018-03-06T00:00:00.0000000Z"

пример 2

Предположим, что текущая метка времени — "2018-03-01T00:00:0000000Z". Этот пример добавляет пять дней и преобразует результат в формат D:

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

И возвращает этот результат: "Tuesday, March 6, 2018"

getPastTime

Возвращает текущую метку времени минус указанные единицы времени.

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

пример 1

Предположим, что текущая метка времени — "2018-02-01T00:00:000000Z". В этом примере вычитается пять дней из этой временной метки.

getPastTime(5, 'Day')

И возвращает этот результат: "2018-01-27T00:00:00.0000000Z"

пример 2

Предположим, что текущая метка времени — "2018-02-01T00:00:000000Z". В этом примере вычитается пять дней и преобразуется результат в формат D:

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

И возвращает этот результат: "Saturday, January 27, 2018"

больше

Проверьте, больше ли первое значение, чем второе значение. Возвращает значение true, если первое значение больше или возвращает значение false, если меньше.

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

пример

В этих примерах проверяется, больше ли первое значение, чем второе:

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

И верните следующие результаты:

• Первый пример: true
• Второй пример: false

больше или равно

Проверьте, больше ли первое значение или равно второму значению. Возвращает значение true, если первое значение больше или равно, или возвращает значение false, если первое значение меньше.

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

пример

В этих примерах проверяется, больше ли первое значение или равно второму значению:

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

И верните следующие результаты:

• Первый пример: true
• Второй пример: false

гид

Создайте глобальный уникальный идентификатор (GUID) в виде строки, например "c2ecc88d-88c8-4096-912c-d6f2e2e2b138ce":

guid()

Кроме того, можно указать другой формат GUID, отличный от формата по умолчанию "D", который составляет 32 цифры, разделенные дефисом.

guid('<format>')

пример

В этом примере создается тот же GUID, но как 32 цифры, разделенные дефисами и заключенные в скобки:

guid('P')

И возвращает этот результат: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

если

Проверьте, имеет ли выражение значение true или false. В зависимости от результата возвращается указанное значение.

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

пример

В этом примере возвращается "yes", так как указанное выражение возвращает значение true. В противном случае в примере возвращается "no":

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

indexOf

Возвращает начальную позицию или значение индекса для подстроки. Эта функция не учитывает регистр, и индексы начинаются с числа 0.

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

пример

Этот пример находит начальное значение индекса для подстроки "world" в строке hello world:

indexOf('hello world', 'world')

И возвращает этот результат: 6

int

Возвращает целочисленную версию строки.

int('<value>')

Пример

В этом примере создается целочисленная версия строки "10":

int('10')

И возвращает этот результат: 10

json

Возвращает значение типа нотации объектов JavaScript (JSON) или объект для строки или XML.

json('<value>')

пример 1

В этом примере эта строка преобразуется в значение JSON:

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

И возвращает этот результат: [1, 2, 3]

пример 2

В этом примере эта строка преобразуется в JSON:

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

И возвращает следующий результат:

{
  "fullName": "Sophia Owen"
}

пример 3

В этом примере этот XML-код преобразуется в JSON:

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

И возвращает следующий результат:

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

пересечение

Возвращает коллекцию, содержащую только и общие элементы через указанные коллекции. Чтобы появиться в результате, элемент должен отображаться во всех коллекциях, переданных этой функции. Если одно или несколько элементов имеют то же имя, последний элемент с этим именем отображается в результате.

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

пример

В этом примере находятся общие элементы в этих массивах:

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

И возвращает массив, содержащий только эти элементы:[1, 2]

присоединиться / вступить

Возвращает строку, содержащую все элементы массива, где каждый символ разделен разделителем .

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

пример

В этом примере создается строка из всех элементов этого массива с указанным символом в качестве разделителя:

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

И возвращает этот результат: "a.b.c"

последний

Возвращает последний элемент из коллекции.

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

пример

В этих примерах показано, как найти последний элемент в этих коллекциях.

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

И возвращает следующие результаты:

• Первый пример: "d"
• Второй пример: 3

lastIndexOf

Возвращает начальную позицию или индекс последнего вхождения подстроки. Эта функция не учитывает регистр, и индексы начинаются с числа 0.

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

пример

Этот пример находит начальное значение индекса для последнего вхождения подстроки "world" в строке hello world:

lastIndexOf('hello world', 'world')

И возвращает этот результат: 6

длина

Возвращает количество элементов в коллекции.

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

Пример

Примеры показывают количество элементов в этих коллекциях:

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

И верните этот результат: 4

менее

Проверьте, меньше ли первое значение, чем второе значение. Возвращает значение true, если первое значение меньше или возвращает значение false, если первое значение больше.

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

Пример

В этих примерах проверяется, меньше ли первое значение, чем второе.

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

И верните следующие результаты:

• Первый пример: true
• Второй пример: false

меньшеИлиРавно

Проверьте, меньше ли первое значение или равно второму значению. Возвращает значение true, если первое значение меньше или равно, или возвращает значение false, если первое значение больше.

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

пример

В этих примерах проверяется, является ли первое значение меньше или равно второму значению.

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

И верните следующие результаты:

• Первый пример: true
• Второй пример: false

Макс

Возвращает наибольшее значение из списка или массива с числами, которые являются включающими в обоих концах.

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

Пример

Эти примеры получают наибольшее значение из набора чисел и массива:

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

И верните этот результат: 3

Мин

Возвращает наименьшее значение из набора чисел или массива.

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

пример

Эти примеры получают наименьшее значение в наборе чисел и массиве:

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

И верните этот результат: 1

модуль

Верните остаток от деления двух чисел. Сведения о получении целочисленного результата см. в разделе div().

mod(<dividend>, <divisor>)

пример

В этом примере первый номер делится на второй номер:

mod(3, 2)

И верните этот результат: 1

мул

Возвращает результат умножения двух чисел.

mul(<multiplicand1>, <multiplicand2>)

пример

В этих примерах умножают первое число на второе число.

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

И верните следующие результаты:

• Первый пример: 2
• Второй пример 3

не

Проверьте, является ли выражение ложным. Возвращает значение true, если выражение имеет значение false или возвращает значение false, если значение true.

not(<expression>)

пример 1

В этих примерах проверяется, являются ли указанные выражения ложными:

not(false)
not(true)

И верните следующие результаты:

• Первый пример: выражение равно false, поэтому функция возвращает true.
• Второй пример: выражение имеет значение true, поэтому функция возвращает false.

пример 2

В этих примерах проверяется, являются ли указанные выражения ложными:

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

И верните следующие результаты:

• Первый пример: выражение равно false, поэтому функция возвращает true.
• Второй пример: выражение имеет значение true, поэтому функция возвращает false.

или

Проверьте, является ли по крайней мере одно выражение истинным. Возвращает значение true, если по крайней мере одно выражение имеет значение true, или возвращает значение false, если оба выражения имеют значение false.

or(<expression1>, <expression2>)

пример 1

В этих примерах проверяется, является ли по крайней мере одно выражение истинным:

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

И верните следующие результаты:

• Первый пример: по крайней мере одно выражение имеет значение true, поэтому функция возвращает true.
• Второй пример: оба выражения являются false, поэтому функция возвращает false.

пример 2

В этих примерах проверяется, является ли по крайней мере одно выражение истинным:

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

Пожалуйста, верните следующие результаты:

• Первый пример: по крайней мере одно выражение имеет значение true, поэтому функция возвращает true.
• Второй пример: оба выражения являются false, поэтому функция возвращает false.

ранд

Возвращает случайное целое число из указанного диапазона, включая только начальное значение.

rand(<minValue>, <maxValue>)

пример

В этом примере возвращается случайное целое число из указанного диапазона, за исключением максимального значения:

rand(1, 5)

И возвращает одно из этих чисел в результате: 1, 2, 3или 4

диапазон

Возвращает целый массив, начинающийся с указанного целого числа.

range(<startIndex>, <count>)

пример

В этом примере создается целый массив, начинающийся с указанного индекса и имеющий указанное число целых чисел:

range(1, 4)

И возвращает этот результат: [1, 2, 3, 4]

заменять

Замените подстроку указанной строкой и верните строку результата. Эта функция чувствительна к регистру.

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

пример

Этот пример находит подстроку "old" в "старой строке" и заменяет "старый" на "new":

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

И возвращает этот результат: "the new string"

пропустить

Удалите элементы из передней части коллекции и верните все остальные элементы.

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

пример

В этом примере удаляется один элемент, число 0, из передней части указанного массива:

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

И возвращает этот массив с оставшимися элементами: [1,2,3]

разделять

Возвращает массив, содержащий подстроки, разделенные запятыми, на основе указанного символа разделителя в исходной строке.

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

пример

В этом примере создается массив со подстроками из указанной строки на основе указанного символа в качестве разделителя:

split('a_b_c', '_')

И возвращает этот массив в качестве результата: ["a","b","c"]

начало дня

Верните начало дня для метки времени.

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

пример

Этот пример находит начало дня для этой временной метки.

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

И возвращает этот результат: "2018-03-15T00:00:00.0000000Z"

началоЧаса

Возвращает начало часа для метки времени.

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

пример

Этот пример определяет начало часа для этой временной метки.

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

И возвращает этот результат: "2018-03-15T13:00:00.0000000Z"

началоМесяца

Возвращает начало месяца для метки времени.

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

пример

В этом примере возвращается начало месяца для этой метки времени.

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

И возвращает этот результат: "2018-03-01T00:00:00.0000000Z"

начинается с

Проверьте, начинается ли строка с определенной подстроки. Возвращает значение true при обнаружении подстроки или возвращает значение false, если он не найден. Эта функция не учитывает регистр.

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

пример 1

В этом примере проверяется, начинается ли строка hello world со подстроки hello:

startsWith('hello world', 'hello')

И возвращает этот результат: true

пример 2

В этом примере проверяется, начинается ли строка hello world со подстроки приветствия:

startsWith('hello world', 'greetings')

И возвращает этот результат: false

струна

Возвращает строковую версию для значения.

string(<value>)

пример 1

В этом примере создается строковое представление для этого числа.

string(10)

И возвращает этот результат: "10"

пример 2

В этом примере создается строка для указанного объекта JSON и используется символ обратной косой черты (\) в качестве символа экранирования для двойной кавычки (").

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

И возвращает этот результат: "{ \\"name\\": \\"Sophie Owen\\" }"

суб

Возвращает результат вычитания второго числа из первого числа.

sub(<minuend>, <subtrahend>)

пример

В этом примере вычитается второй номер из первого числа:

sub(10.3, .3)

И возвращает этот результат: 10

подстрока

Возвращает символы из строки, начиная с указанной позиции или индекса. Значения индекса начинаются с числа 0.

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

пример

В этом примере создается подстрока с пятью символами из указанной строки, начиная с значения индекса 6:

substring('hello world', 6, 5)

И возвращает этот результат: "world"

вычестьИзВремени

Вычтите количество единиц времени из метки времени. См. также getPastTime.

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

пример 1

В этом примере вычитается один день из этой временной записи.

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

И возвращает этот результат: "2018-01-01T00:00:00:0000000Z"

пример 2

В этом примере из отметки времени вычитается один день:

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

И возвращает этот результат с помощью необязательного формата D: "Monday, January, 1, 2018"

брать

Возвращать элементы из передней части коллекции.

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

Пример

В этих примерах берется указанное количество элементов с начала данных коллекций.

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

И верните следующие результаты:

• Первый пример: "abc"
• Второй пример: [0, 1, 2]

Клещи

Возвращает значение свойства ticks для указанной метки времени. галочки — это 100-наносекундный интервал.

ticks('<timestamp>')

toLower

Возвращает строку в нижнем регистре. Если символ в строке не имеет строчной версии, этот символ остается неизменным в возвращаемой строке.

toLower('<text>')

пример

В этом примере эта строка преобразуется в нижний регистр:

toLower('Hello World')

И возвращает этот результат: "hello world"

toUpper

Возвращает строку в верхнем регистре. Если символ в строке не имеет версию верхнего регистра, этот символ остается неизменным в возвращаемой строке.

toUpper('<text>')

пример

В этом примере эта строка преобразуется в верхний регистр:

toUpper('Hello World')

И возвращает этот результат: "HELLO WORLD"

подстригать

Удалите начальные и конечные пробелы из строки и верните обновленную строку.

trim('<text>')

пример

В этом примере удаляются начальные и конечные пробелы из строки "Hello World":

trim(' Hello World  ')

И возвращает этот результат: "Hello World"

союз

Возвращает коллекцию, которая содержит все элементы из указанных коллекций. Чтобы появиться в результате, элемент может отображаться в любой коллекции, переданной этой функции. Если одно или несколько элементов имеют то же имя, последний элемент с этим именем отображается в результате.

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

пример

В этом примере получает все элементы из этих коллекций.

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

И возвращает этот результат: [1, 2, 3, 10, 101]

URI-компонент

Возврат кодированной версии универсального идентификатора ресурса (URI) для строки путем замены небезопасных для URL символов на специальные символы. Используйте эту функцию, а не encodeUriComponent(). Хотя обе функции работают одинаково, uriComponent() предпочтительнее.

uriComponent('<value>')

пример

В этом примере создается версия в кодировке URI для этой строки:

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

И возвращает этот результат: "http%3A%2F%2Fcontoso.com"

URIComponentToBinary

Возвращает двоичную версию для компонента универсального идентификатора ресурса (URI).

uriComponentToBinary('<value>')

пример

В этом примере создается двоичная версия для этой строки в кодировке URI:

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

И возвращает следующий результат:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

URIComponentToString

Возвращает строковую версию для закодированной строки с универсальным кодом ресурса (URI), эффективно декодируя строку в кодировке URI.

uriComponentToString('<value>')

пример

В этом примере создается декодированная версия строки для этой строки в кодировке URI:

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

И возвращает этот результат: "https://contoso.com"

UTCNow

Возвращает текущую метку времени.

utcNow('<format>')

При необходимости можно указать другой формат с параметром <формата>.

пример 1

Предположим, сегодня 15 апреля 2018 г. в 1:00:00 вечера. В этом примере возвращается текущая метка времени:

utcNow()

И возвращает этот результат: "2018-04-15T13:00:00.0000000Z"

пример 2

Предположим, сегодня 15 апреля 2018 г. в 1:00:00 вечера. В этом примере текущая метка времени получается с помощью необязательного формата "D":

utcNow('D')

И возвращает этот результат: "Sunday, April 15, 2018"

xml

Возвращает XML-версию для строки, содержащей объект JSON.

xml('<value>')

пример 1

В этом примере создается XML-версия для этой строки, которая содержит объект JSON:

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

И возвращает xml-код результата:

<name>Sophia Owen</name>

пример 2

Предположим, у вас есть этот объект JSON:

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

В этом примере создается XML-код для строки, содержащей этот объект JSON:

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

И возвращает xml-код результата:

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

xpath

Проверяйте соответствие узлов или значений XML выражению XPath (язык запросов XML) и возвращайте найденные узлы или значения. Выражение XPath или просто XPath помогает перемещаться по структуре XML-документа, чтобы можно было выбрать узлы или значения вычислений в XML-содержимом.

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

пример 1

Продолжая из Примера 1, этот пример находит узлы, которые соответствуют узлу <count></count>, и добавляет их значения с помощью функции sum().

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

И возвращает этот результат: 30

пример 2

В этом примере оба выражения находят узлы, соответствующие узлу <location></location>, в указанных аргументах, которые включают XML с пространством имен. Выражения используют символ обратной косой черты (\) в качестве escape-символа для двойной кавычки ().

• выражение 1

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

• выражение 2

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

Ниже приведены аргументы:

• Этот XML,который включает пространство имен XML-документа, xmlns="http://contoso.com":

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

• Любое выражение XPath здесь:

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

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

Вот узел результата, соответствующий узлу <location></location>:

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

пример 3

На основе Примера 3, данный пример находит значение в узле <location></location>:

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

И возвращает этот результат: "Paris"

Связанное содержимое

Для получения инструкций по общему использованию параметров см. раздел Параметры для фабрики данных в Fabric