Функции таблиц

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

Построение таблицы

Имя	Описание
#table	Создает табличное значение из столбцов и строк.
ItemExpression.From	Возвращает абстрактное дерево синтаксиса (AST) для текста функции.
RowExpression.Column	Возвращает абстрактное дерево синтаксиса (AST), представляющее доступ к столбцу в выражении строки.
RowExpression.From	Возвращает абстрактное дерево синтаксиса (AST) для текста функции.
Table.FromColumns	Создает таблицу из списка столбцов и указанных значений.
Table.FromList	Преобразует список в таблицу, применяя указанную функцию разделения к каждому элементу в списке.
Table.FromRecords	Преобразует список записей в таблицу.
Table.FromRows	Создает таблицу из списка значений строк и необязательных столбцов.
Table.FromValue	Создает таблицу со столбцом из предоставленного значения или значений.
Table.WithErrorContext	Эта функция предназначена только для внутреннего использования.
Table.View	Создает или расширяет таблицу с определяемыми пользователем обработчиками для операций запроса и действий.
Table.ViewError	Создает измененную запись ошибки, которая не активирует резервную передачу при возникновении обработчиком, определенным в представлении (через Table.View).
Table.ViewFunction	Создает функцию, которую можно перехватывать обработчиком, определенным в представлении (через Table.View).

Преобразования

Имя	Описание
Table.ToColumns	Создает список вложенных списков значений столбцов из таблицы.
Table.ToList	Преобразует таблицу в список, применяя указанную функцию объединения к каждой строке значений в таблице.
Table.ToRecords	Преобразует таблицу в список записей.
Table.ToRows	Создает список вложенных списков значений строк из таблицы.

Информация

Имя	Описание
Table.ApproximateRowCount	Возвращает приблизительное количество строк в таблице.
Table.ColumnCount	Возвращает количество столбцов в таблице.
Table.IsEmpty	Указывает, содержит ли таблица любые строки.
Table.PartitionValues	Возвращает сведения о том, как таблица разбита на секции.
Table.Profile	Возвращает профиль столбцов таблицы.
Table.RowCount	Возвращает количество строк в таблице.
Table.Schema	Возвращает таблицу, содержащую описание столбцов (то есть схемы) указанной таблицы.
Tables.GetRelationships	Возвращает связи между набором таблиц.

Строковые операции

Имя	Описание
Table.AlternateRows	Сохраняет начальное смещение, затем чередует взятие и пропуск следующих строк.
Table.Combine	Возвращает таблицу, которая является результатом объединения списка таблиц.
Table.FindText	Возвращает все строки, содержащие заданный текст в таблице.
Table.First	Возвращает первую строку или указанное значение по умолчанию.
Table.FirstN	Возвращает указанное количество первых строк.
Table.FirstValue	Возвращает первый столбец первой строки таблицы или указанное значение по умолчанию.
Table.FromPartitions	Возвращает таблицу, которая является результатом объединения набора секционированных таблиц.
Table.InsertRows	Вставляет список строк в таблицу по указанной позиции.
Table.Last	Возвращает последнюю строку или указанное значение по умолчанию.
Table.LastN	Возвращает последнее указанное число строк.
Table.MatchesAllRows	Указывает, соответствуют ли все строки в таблице заданному условию.
Table.MatchesAnyRows	Указывает, соответствуют ли строки в таблице заданному условию.
Table.Partition	Секционирует таблицу в список таблиц на основе количества групп и столбцов.
Table.Range	Возвращает строки, начинающиеся с указанного смещения.
Table.RemoveFirstN	Возвращает таблицу с указанным числом строк, удаленных из таблицы, начиная с первой строки.
Table.RemoveLastN	Возвращает таблицу с указанным числом строк, удаленных из таблицы, начиная с последней строки.
Table.RemoveRows	Удаляет указанное количество строк.
Table.RemoveRowsWithErrors	Возвращает таблицу со строками, удаленными из входной таблицы, содержащей ошибку по крайней мере в одной из ячеек. Если указан список столбцов, проверяются только ячейки в указанных столбцах.
Table.Repeat	Повторяет строки таблиц заданное число раз.
Table.ReplaceRows	Заменяет указанный диапазон строк предоставленными строками или строками.
Table.ReverseRows	Возвращает таблицу со строками в обратном порядке.
Table.SelectRows	Выбирает строки, соответствующие функции условия.
Table.SelectRowsWithErrors	Возвращает таблицу только с этими строками входной таблицы, содержащей ошибку по крайней мере в одной из ячеек. Если указан список столбцов, проверяются только ячейки в указанных столбцах.
Table.SingleRow	Возвращает одну строку в таблице.
Table.Skip	Возвращает таблицу с первым указанным числом пропущенных строк.
Table.SplitAt	Возвращает список, содержащий указанное количество первых строк и оставшиеся строки.

Операции столбцов

Имя	Описание
Table.Column	Возвращает указанный столбец данных из таблицы в виде списка.
Table.ColumnNames	Возвращает имена столбцов в виде списка.
Table.ColumnsOfType	Возвращает список с именами столбцов, которые соответствуют указанным типам.
Table.DemoteHeaders	Понижение заголовков столбцов до первой строки значений.
Table.DuplicateColumn	Дублирует столбец с указанным именем. Значения и тип копируются из исходного столбца.
Table.HasColumns	Указывает, содержит ли таблица указанный столбец или столбцы.
Table.Pivot	При наличии пары столбцов, представляющих пары атрибут-значение, данные из столбца атрибутов преобразуются в заголовки столбцов.
Table.PrefixColumns	Возвращает таблицу, в которой все столбцы были префиксированы с заданным текстом.
Table.PromoteHeaders	Преобразует первую строку значений в новые заголовки столбцов (т.е. названия столбцов).
Table.RemoveColumns	Удаляет указанные столбцы.
Table.ReorderColumns	Возвращает таблицу со столбцами в указанном порядке.
Table.RenameColumns	Возвращает таблицу с переименованными столбцами в соответствии с заданными указаниями.
Table.SelectColumns	Возвращает таблицу только с указанными столбцами.
Table.TransformColumnNames	Преобразует имена столбцов с помощью данной функции.
Table.Unpivot	Преобразует столбцы таблицы в пары атрибут-значение.
Table.UnpivotOtherColumns	Преобразует все столбцы, отличные от указанного набора, в пары атрибут-значение.

Преобразование

Имя	Описание
Table.AddColumn	Добавляет столбец с указанным именем. Значение вычисляется с помощью указанной функции выбора с каждой строкой, взятой в качестве входных данных.
Table.AddFuzzyClusterColumn	Добавляет новый столбец с репрезентативными значениями, полученными нечеткими значениями группировки указанного столбца в таблице.
Table.AddIndexColumn	Добавляет столбец с явными значениями позиции.
Table.AddJoinColumn	Выполняет соединение между таблицами в предоставленных столбцах и создает результат соединения в новом столбце.
Table.AddKey	Добавляет ключ в таблицу.
Table.AggregateTableColumn	Объединяет столбец таблиц в несколько столбцов в содержащейся таблице.
Table.CombineColumns	Объединяет указанные столбцы в новый столбец с помощью указанной функции объединения.
Table.CombineColumnsToRecord	Объединяет указанные столбцы в новый столбец с значением записи, где каждая запись содержит имена полей и значения, соответствующие именам столбцов и значениям объединенных столбцов.
Table.ConformToPageReader	Эта функция предназначена только для внутреннего использования.
Table.ExpandListColumn	Учитывая столбец списков в таблице, создайте копию строки для каждого значения в списке.
Table.ExpandRecordColumn	Развертывает столбец записей в столбцы с каждым из значений.
Table.ExpandTableColumn	Расширяет столбец записей или столбец таблиц в несколько столбцов внутри содержащей таблицы.
Table.FillDown	Распространяет значение предыдущей ячейки на ячейки с значением NULL ниже в столбце.
Table.FillUp	Распространяет значение ячейки на ячейки с NULL-значением выше в столбце.
Table.FilterWithDataTable	Эта функция предназначена только для внутреннего использования.
Table.FuzzyGroup	Группирует строки в таблице на основе нечеткого сопоставления ключей.
Table.FuzzyJoin	Объединяет строки из двух таблиц, которые приближенно совпадают по заданным ключам.
Table.FuzzyNestedJoin	Выполняет нечеткое соединение между таблицами в предоставленных столбцах и создает результат соединения в новом столбце.
Table.Group	Группирует строки в таблице с одинаковым ключом.
Table.Join	Объединяет строки из двух таблиц, которые соответствуют заданным ключам.
Table.Keys	Возвращает ключи указанной таблицы.
Table.NestedJoin	Выполняет соединение между таблицами в предоставленных столбцах и создает результат соединения в новом столбце.
Table.PartitionКлюч	Возвращает разделительный ключ указанной таблицы.
Table.ReplaceErrorValues	Заменяет значения ошибок в указанных столбцах соответствующим указанным значением.
Table.ReplaceKeys	Заменяет ключи указанной таблицы.
Table.ReplacePartitionKey	Заменяет ключ раздела в указанной таблице.
Table.ReplaceRelationshipIdentity	Эта функция предназначена только для внутреннего использования.
Table.ReplaceValue	Заменяет одно значение другим в указанных столбцах.
Table.Split	Разбивает указанную таблицу в список таблиц, используя указанный размер страницы.
Table.SplitColumn	Разделяет указанный столбец на набор дополнительных столбцов с помощью указанной функции разделения.
Table.TransformColumns	Преобразует значения одного или нескольких столбцов.
Table.TransformColumnTypes	Применяет преобразования типов формы { столбец, тип } с использованием определенного языка и региональных параметров.
Table.TransformRows	Преобразует строки таблицы с помощью указанной функции преобразования.
Table.Transpose	Превращает столбцы в строки и строки в столбцы.

Членство

Имя	Описание
Table.Contains	Указывает, отображается ли указанная запись в виде строки в таблице.
Table.ContainsAll	Указывает, отображаются ли все указанные записи в виде строк в таблице.
Table.ContainsAny	Указывает, отображается ли какая-либо из указанных записей в виде строк в таблице.
Table.Distinct	Удаляет повторяющиеся строки из таблицы.
Table.IsDistinct	Указывает, содержит ли таблица только отдельные строки (без дубликатов).
Table.PositionOf	Возвращает позицию или позиции строки в таблице.
Table.PositionOfAny	Возвращает позицию или позиции любой из указанных строк в таблице.
Table.RemoveMatchingRows	Удаляет все указанные строки из таблицы.
Table.ReplaceMatchingRows	Заменяет все указанные строки предоставленными строками или строками.

Заказ

Имя	Описание
Table.AddRankColumn	Добавляет столбец с ранжированием одного или нескольких других столбцов.
Table.Max	Возвращает наибольшее значение строки или значения по умолчанию с помощью заданных условий.
Table.MaxN	Возвращает самую большую строку или строки с помощью заданных условий.
Table.Min	Возвращает наименьшую строку или значение по умолчанию, используя заданные критерии.
Table.MinN	Возвращает наименьшую строку или строки с помощью заданных условий.
Table.Sort	Сортирует таблицу с помощью одного или нескольких имен столбцов и критериев сравнения.

Другой

Имя	Описание
Table.Buffer	Буферизирует таблицу в памяти, изолируя ее от внешних изменений во время оценки.
Table.StopFolding	Предотвращает выполнение последующих операций в отношении исходного источника данных.

Значения параметров

Именование выходных столбцов

Этот параметр представляет собой список текстовых значений, указывающих имена столбцов результирующей таблицы. Этот параметр обычно используется в функциях построения таблиц , таких как Table.FromRows и Table.FromList.

Критерии сравнения

Критерий сравнения можно указать как одно из следующих значений:

• Числовое значение, указывающее порядок сортировки. Дополнительные сведения: порядок сортировки

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

• Чтобы выбрать ключ и порядок управления, критерий сравнения может быть списком, содержащим ключ и порядок.

• Для полного управления сравнением можно использовать функцию двух аргументов, возвращающую значение -1, 0 или 1 с учетом связи между левыми и правыми входными данными. Value.Compare можно использовать для делегирования этой логики.

Например, перейдите к описанию Table.Sort.

Критерии подсчета или условия

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

• Число указывает, сколько значений следует возвращать в соответствии с соответствующей функцией.

• Если указано условие, возвращаются строки, содержащие значения, которые изначально соответствуют условию. После сбоя условия никакие дополнительные значения не учитываются.

Дополнительные сведения: Table.FirstN, Table.MaxN

Обработка дополнительных значений

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

ExtraValues.List = 0
ExtraValues.Error = 1
ExtraValues.Ignore = 2

Дополнительные сведения: Table.FromList, ExtraValues.Type

Обработка отсутствующих столбцов

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

MissingField.Error = 0
MissingField.Ignore = 1
MissingField.UseNull = 2;

Этот параметр используется в операциях со столбцами или преобразованиями, таких как Table.TransformColumns. Дополнительные сведения: MissingField.Type

Порядок сортировки

Порядок сортировки используется для указания способа сортировки результатов. Этот параметр указывается как число, которое сопоставляется со следующими параметрами:

Order.Ascending = 0
Order.Descending = 1

Дополнительные сведения: Order.Type

Критерии уравнения

Критерии уравнения для таблиц можно указать следующим образом:

• Значение функции, которое может быть следующим:

  • Селектор ключей, определяющий столбец в таблице для применения критериев равенства.

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

• Список столбцов в таблице для применения критериев равенства.

Например, перейдите к описанию Table.Distinct.