Функции таблиц
Эти функции создают и управляют значениями таблиц.
Построение таблицы
| Имя | Описание |
|---|---|
| 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 | Учитывая таблицу и столбец атрибутов, содержащий сводные значения, создает новые столбцы для каждого из значений сводной таблицы и назначает их значения из valueColumn. Необязательный агрегатFunction можно предоставить для обработки нескольких вхождений одного и того же значения ключа в столбце атрибутов. |
| 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.SplitColumns. |
| Table.CombineColumnsToRecord | Объединяет указанные столбцы в новый столбец с значением записи, где каждая запись содержит имена полей и значения, соответствующие именам столбцов и значениям объединенных столбцов. |
| Table.ConformToPageReader | Эта функция предназначена только для внутреннего использования. |
| Table.ExpandListColumn | Учитывая столбец списков в таблице, создайте копию строки для каждого значения в списке. |
| Table.ExpandRecordColumn | Развертывает столбец записей в столбцы с каждым из значений. |
| Table.ExpandTableColumn | Развертывает столбец записей или столбец таблиц в несколько столбцов в содержащейся таблице. |
| Table.FillDown | Заменяет значения NULL в указанном столбце или столбцах таблицы последним значением, не имеющим значения NULL в столбце. |
| Table.FillUp | Возвращает таблицу из таблицы, указанной, где значение следующей ячейки распространяется на ячейки null значений выше в указанном столбце. |
| Table.FilterWithDataTable | Эта функция предназначена только для внутреннего использования. |
| Table.Group | Группирует строки таблиц по значениям ключевых столбцов для каждой строки. |
| Table.Join | Объединяет строки таблицы 1 со строками таблицы 2 на основе равенства значений ключевых столбцов, выбранных в таблице1, key1 и table2, key2. |
| Table.Keys | Возвращает ключи указанной таблицы. |
| Table.NestedJoin | Объединяет строки таблиц на основе равенства ключей. Результаты вводятся в новый столбец. |
| Table.ReplaceErrorValues | Заменяет значения ошибок в указанных столбцах соответствующим указанным значением. |
| Table.ReplaceKeys | Заменяет ключи указанной таблицы. |
| Table.ReplaceRelationshipIdentity | Эта функция предназначена только для внутреннего использования. |
| Table.ReplaceValue | Заменяет старое значение newValue в определенных столбцах таблицы с помощью предоставленной функции замены, например текста. Замена или значение.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 | Возвращает самую большую строку или строки из таблицы с помощью сравненияCriteria. |
| Table.MaxN | Возвращает самые большие N-строки из таблицы. После сортировки строк параметр countOrCondition должен быть указан для дальнейшего фильтрации результата. |
| Table.Min | Возвращает наименьшую строку или строки из таблицы с помощью сравненияCriteria. |
| Table.MinN | Возвращает наименьшие N-строки в данной таблице. После сортировки строк параметр countOrCondition должен быть указан для дальнейшего фильтрации результата. |
| Table.AddRankColumn | Добавляет столбец с ранжированием одного или нескольких других столбцов. |
| Table.Sort | Сортирует строки в таблице, используя сравнениеCriteria или порядок по умолчанию, если он не указан. |
Другой
| Имя | Описание |
|---|---|
| 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.