Прочитать на английском

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


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

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

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

Имя Описание
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.FuzzyGroup Группирует строки таблицы, нечетко сопоставляя значения в указанном столбце для каждой строки.
Table.FuzzyJoin Объединяет строки из двух таблиц, которые приближенно совпадают по заданным ключам.
Table.FuzzyNestedJoin Выполняет нечеткое соединение между таблицами в предоставленных столбцах и создает результат соединения в новом столбце.
Table.Split Разбивает указанную таблицу в список таблиц, используя указанный размер страницы.
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 Возвращает значение true, если таблица не содержит строк.
Table.Profile Возвращает профиль столбцов таблицы.
Table.RowCount Возвращает количество строк в таблице.
Table.Schema Возвращает таблицу, содержащую описание столбцов (т. е. схемы) указанной таблицы.
Tables.GetRelationships Возвращает связи между набором таблиц.

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

Имя Описание
Table.AlternateRows Возвращает таблицу, содержащую чередующийся шаблон строк из таблицы.
Table.Combine Возвращает таблицу, которая является результатом объединения списка таблиц. Все таблицы должны иметь одинаковую структуру типа строки.
Table.FindText Возвращает таблицу, содержащую только строки, содержащие указанный текст в одной из своих ячеек или любую ее часть.
Table.First Возвращает первую строку из таблицы.
Table.FirstN Возвращает первые строки таблицы в зависимости от параметра countOrCondition.
Table.FirstValue Возвращает первый столбец первой строки таблицы или указанное значение по умолчанию.
Table.FromPartitions Возвращает таблицу, которая является результатом объединения набора секционированных таблиц в новые столбцы. Тип столбца можно указать при необходимости, значение по умолчанию — любое.
Table.InsertRows Возвращает таблицу со списком строк, вставленных в таблицу по индексу. Каждая строка для вставки должна соответствовать типу строки таблицы..
Table.Last Возвращает последнюю строку таблицы.
Table.LastN Возвращает последние строки из таблицы в зависимости от параметра countOrCondition.
Table.MatchesAllRows Возвращает значение true, если все строки таблицы соответствуют условию.
Table.MatchesAnyRows Возвращает значение true, если любая из строк в таблице соответствует условию.
Table.Partition Секционирует таблицу, разбивая её на группы таблиц на основе значений в столбцах каждой из строк и хэш-функции. Хэш-функция применяется к значению столбца строки для получения хэш-значения строки. Группы модулированных хэш-значений определяют, в каких из возвращаемых таблиц будет помещена строка.
Table.PartitionValues Возвращает сведения о том, как таблица разбита на секции.
Table.Range Возвращает из таблицы указанное количество строк, начиная с заданного смещения.
Table.RemoveFirstN Возвращает таблицу с указанным числом строк, удаленных из таблицы, начиная с первой строки. Количество удаленных строк зависит от необязательного параметра countOrCondition.
Table.RemoveLastN Возвращает таблицу с указанным числом строк, удаленных из таблицы, начиная с последней строки. Количество удаленных строк зависит от необязательного параметра countOrCondition.
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 Добавляет столбец с именем newColumnName в таблицу.
Table.AddFuzzyClusterColumn Добавляет новый столбец с репрезентативными значениями, полученными нечеткими значениями группировки указанного столбца в таблице.
Table.AddIndexColumn Возвращает таблицу с новым столбцом с определенным именем, которое для каждой строки содержит индекс строки в таблице.
Table.AddJoinColumn Выполняет вложенное соединение между таблицей1 и таблицей2 из определенных столбцов и создает результат соединения в виде нового столбцаColumnName для каждой строки таблицы1.
Table.AddKey Добавляет ключ в таблицу.
Table.AggregateTableColumn Агрегирует таблицы, вложенные в определенный столбец, в несколько столбцов, содержащих статистические значения для этих таблиц.
Table.CombineColumns Table.CombineColumns объединяет столбцы с помощью функции объединения для создания нового столбца. Table.CombineColumns является обратным значением Table.SplitColumnс.
Table.CombineColumnsToRecord Объединяет указанные столбцы в новый столбец с значением записи, где каждая запись содержит имена полей и значения, соответствующие именам столбцов и значениям объединенных столбцов.
Table.ConformToPageReader Эта функция предназначена только для внутреннего использования.
Table.ExpandListColumn Учитывая столбец списков в таблице, создайте копию строки для каждого значения в списке.
Table.ExpandRecordColumn Развертывает столбец записей в столбцы с каждым из значений.
Table.ExpandTableColumn Расширяет столбец записей или столбец таблиц в несколько столбцов внутри содержащей таблицы.
Table.FillDown Заменяет значения NULL в указанном столбце или столбцах таблицы последним значением, не имеющим значения NULL в столбце.
Table.FillUp Возвращает таблицу из указанной таблицы, где значение следующей ячейки распространяется на пустые ячейки выше в указанном столбце.
Table.FilterWithDataTable Эта функция предназначена только для внутреннего использования.
Table.Group Группирует строки таблиц по значениям ключевых столбцов для каждой строки.
Table.Join Объединяет строки таблицы 1 со строками таблицы 2 на основе равенства значений ключевых столбцов, выбранных таблицей 1, key1, и таблицей 2, key2.
Table.Keys Возвращает ключи указанной таблицы.
Table.NestedJoin Объединяет строки таблиц на основе равенства ключей. Результаты вводятся в новый столбец.
Table.ReplaceErrorValues Заменяет значения ошибок в указанных столбцах соответствующим указанным значением.
Table.ReplaceKeys Заменяет ключи указанной таблицы.
Table.ReplaceRelationshipIdentity Эта функция предназначена только для внутреннего использования.
Table.ReplaceValue Заменяет старое значение на новое значение в определенных столбцах таблицы с помощью заданной функции замены, например, text.Replace или Value.Replace.
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.Max Возвращает наибольшую строку или строки из таблицы с помощью критериев сравнения.
Table.MaxN Возвращает самые большие N-строки из таблицы. После сортировки строк параметр countOrCondition должен быть указан для дальнейшего фильтрации результата.
Table.Min Возвращает наименьшую строку или строки из таблицы с помощью критерия сравнения.
Table.MinN Возвращает наименьшие N-строки в данной таблице. После сортировки строк параметр countOrCondition должен быть указан для дальнейшего фильтрации результата.
Table.AddRankColumn Добавляет столбец с ранжированием одного или нескольких других столбцов.
Table.Sort Сортирует строки в таблице, используя критерий сравнения или, если критерий не указан, порядок по умолчанию.

Другой

Имя Описание
Table.Buffer Буферизирует таблицу в память, изолируя ее от внешних изменений во время оценки.

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

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

Этот параметр представляет собой список текстовых значений, указывающих имена столбцов результирующей таблицы. Этот параметр обычно используется в функциях построения таблиц, таких как 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.