Поделиться через

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

  • Статья

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

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

Имя Описание
#table Создает табличное значение из столбцов и строк.
ItemExpression.From Возвращает абстрактное дерево синтаксиса (AST) для текста функции.
ItemExpression.Item Узел абстрактного синтаксического дерева (AST), представляющий элемент в элементарном выражении.
RowExpression.Column Возвращает абстрактное дерево синтаксиса (AST), представляющее доступ к столбцу в выражении строки.
RowExpression.From Возвращает абстрактное дерево синтаксиса (AST) для текста функции.
RowExpression.Row Узел абстрактного синтаксического дерева (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.ReplaceErrorValues Заменяет значения ошибок в указанных столбцах соответствующим указанным значением.
Table.ReplaceKeys Заменяет ключи указанной таблицы.
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.