Выражения, значения и разрешить выражение

Языковой запрос формулы Power Query M состоит из шагов выражения формулы, создающих запрос mashup. Выражение формулы можно оценивать (вычислять), возвращая значение. Выражение let инкапсулирует набор значений, вычисляемых, назначенных имен, а затем используется в последующем выражении, которое следует инструкции. Например, выражение let может содержать исходную переменную, равную значению Text.Proper() и возвращающую текстовое значение в правильном случае.

Выражение Let

let
    Source = Text.Proper("hello world")
in
    Source

В приведенном выше примере text.Proper("hello world") оценивается как Hello World.

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

Примитивное значение

Примитивное значение — это однопартийное значение, например число, логический, текст или null. Значение NULL можно использовать для указания отсутствия любых данных.

Тип	Пример значения
Binary	00 00 00 02 // число точек (2)
Дата	5/23/2015
Дата и время	5.23.2015 12:00:00
DateTimeZone	5.23.2015 12:00:00 AM -08:00
Длительность	15:35:00
Логический	True и False
Null;	null
Число	0, 1, -1, 1,5 и 2.3e-5
Текст	"abc"
Time	12:34:12 вечера

Значение функции

Функция — это значение, которое при вызове с аргументами создает новое значение. Функции записываются путем перечисления параметров функции в скобках, а затем символа "идет к",> а затем выражения, определяющего функцию. Например, чтобы создать функцию с именем MyFunction, которая имеет два параметра и выполняет вычисление по параметру1 и параметр2:

let
    MyFunction = (parameter1, parameter2) => (parameter1 + parameter2) / 2
in
    MyFunction

Вызов MyFunction() возвращает результат:

let
    Source = MyFunction(2, 4)
in
    Source

Этот код создает значение 3.

Структурированные значения данных

Язык M поддерживает следующие структурированные значения данных:

• Список

• Запись

• Таблицу

• Дополнительные примеры структурированных данных

Примечание.

Структурированные данные могут содержать любое значение M. Чтобы просмотреть несколько примеров, см . дополнительные примеры структурированных данных.

Список (List)

Список — это упорядоченная от нуля последовательность значений, заключенная в фигурные скобки { }. Фигурные фигурные скобки { } также используются для извлечения элемента из списка по позиции индекса. См. раздел [Значение списка](#_List_value).

Примечание.

Power Query M поддерживает бесконечный размер списка, но если список написан как литерал, список имеет фиксированную длину. Например, {1, 2, 3} имеет фиксированную длину 3.

Ниже приведены некоторые примеры списка .

Значение	Тип
{123, true, "A"}	Список, содержащий число, логический и текстовый текст.
{1, 2, 3}	Список чисел
{     {1, 2, 3},     {4, 5, 6} }	Список чисел
{     [CustomerID = 1, Name = "Bob", Телефон = "123-4567"],     [CustomerID = 2, Name = "Jim", Телефон = "987-6543"] }	Список записей
{123, true, "A"}{0}	Получите значение первого элемента в списке. Это выражение возвращает значение 123.
{     {1, 2, 3},     {4, 5, 6} }{0}{1}	Получите значение второго элемента из первого элемента List. Это выражение возвращает значение 2.

Запись

Запись — это набор полей. Поле — это пара "имя-значение", где имя является текстовым значением, уникальным в записи поля. Синтаксис для значений записей позволяет записывать имена без кавычки, форма также называется идентификаторами. Идентификатор может принимать следующие две формы:

• identifier_name, например OrderID.

• #"имя идентификатора", например, #"Сегодняшняя дата: ".

Ниже приведена запись, содержащая поля "OrderID", "CustomerID", "Item" и "Price" со значениями 1, 1, 1, "Рыболовный удочка" и 100,00. Квадратные фигурные скобки [] указывают начало и конец выражения записи и используются для получения значения поля из записи. В следующих примерах показана запись и получение значения поля Item.

Ниже приведен пример записи:

let Source =
        [
              OrderID = 1,
              CustomerID = 1,
              Item = "Fishing rod",
              Price = 100.00
        ]
in Source

Чтобы получить значение поля "Item", используйте квадратные скобки в формате Source[Item]:

let Source =
    [
          OrderID = 1,
          CustomerID = 1,
          Item = "Fishing rod",
          Price = 100.00
    ]
in Source[Item] //equals "Fishing rod"

Таблицу

Таблица — это набор значений, организованных по именованным столбцам и строкам. Тип столбца может быть неявным или явным. Вы можете использовать #table для создания списка имен столбцов и списка строк. Таблица значений — это список в списке. Фигурные фигурные скобки { } также используются для извлечения строки из таблицы по позиции индекса (перейдите к примеру 3— получение строки из таблицы по позиции индекса).

Пример 1. Создание таблицы с неявными типами столбцов

let
  Source = #table(
    {"OrderID", "CustomerID", "Item", "Price"},
      {
          {1, 1, "Fishing rod", 100.00},
          {2, 1, "1 lb. worms", 5.00}
      })
in
    Source

Пример 2. Создание таблицы с явными типами столбцов

let
    Source = #table(
    type table [OrderID = number, CustomerID = number, Item = text, Price = number],
        {
                {1, 1, "Fishing rod", 100.00},
             {2, 1, "1 lb. worms", 5.00}
        }
    )
in
    Source

Оба приведенных выше примера создают таблицу со следующей фигурой:

OrderID	CustomerID	Товар	Цена,
1	1	Удочку	100.00
2	1	1 lb. черви	5.00

Пример 3. Получение строки из таблицы по позиции индекса

let
    Source = #table(
    type table [OrderID = number, CustomerID = number, Item = text, Price = number],
        {
              {1, 1, "Fishing rod", 100.00},
              {2, 1, "1 lb. worms", 5.00}
         }
    )
in
    Source{1}

Это выражение возвращает следующую запись:

Поле	Стоимость
Orderid	2
Customerid	1
Позиция	1 lb. черви
Price	5

Дополнительные примеры структурированных данных

Структурированные данные могут содержать любое значение M. Ниже приведено несколько примеров:

Пример 1. Список со значениями [Primitive](#_Primitive_value_1), [Function](#_Function_value) и [Record](#_Record_value)

let
    Source =
{
   1,
   "Bob",
   DateTime.ToText(DateTime.LocalNow(), "yyyy-MM-dd"),
   [OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0]
}
in
    Source

При оценке этого выражения можно визуализировать как:

Пример 2. Запись, содержащая примитивные значения и вложенные записи

let
    Source = [CustomerID = 1, Name = "Bob", Phone = "123-4567", Orders =
        {
              [OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],
            [OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0]
        }]
in
    Source

При оценке этого выражения можно визуализировать как:

Примечание.

Хотя многие значения могут быть записаны буквально как выражение, значение не является выражением. Например, выражение 1 оценивается значением 1; Выражение 1+1 оценивается значением 2. Это различие тонко, но важно. Выражения — это рецепты для оценки; значения — это результаты оценки.

Если выражение

Выражение if выбирает между двумя выражениями на основе логического условия. Например:

if 2 > 1 then
    2 + 2
else
    1 + 1

Первое выражение (2 + 2) выбирается, если логическое выражение (2 > 1) имеет значение true, а второй — (1 + 1) — значение false. Выбранное выражение (в данном случае 2 + 2) вычисляется и становится результатом выражения if (4).