通过

表函数

  • 项目

这些函数创建并操纵表值。

构造表

名称 说明
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.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 将作为组合一组分区表的结果的表返回到新的列。 可以选择性地指定列的类型，默认值为 any。
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 中分配它们的值。 可以提供可选的 aggregationFunction 来处理属性列中多次出现的相同键值。
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 从特定列执行 table1 和 table2 之间的嵌套联接，并为 table1 的每一行生成作为 newColumnName 列的联接结果。
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 基于 table1、key1 以及 table2、key2 选择的键列的值的相等性，联接 table1 的行和 table2 的行。
Table.Keys 返回指定表的键。
Table.NestedJoin 基于键的相等性联接表中的行。 结果会输入到新列中。
Table.ReplaceErrorValues 使用相应的指定值替换指定列中的错误值。
Table.ReplaceKeys 替换指定表的键。
Table.ReplaceRelationshipIdentity 此函数仅计划供内部使用。
Table.ReplaceValue 通过使用提供的替换器函数（例如 text.Replace 或 Value.Replace），用 newValue 替换表的特定列中的 oldValue。
Table.SplitColumn 将拆分器函数应用于每个值来从单个列中返回新的一组列。
Table.TransformColumns 转换一个或多个列的值。
Table.TransformColumnTypes 使用类型转换表中的列类型。
Table.TransformRows 使用转换函数转换表中的行。
Table.Transpose 返回一个表，此表将输入表中的列转换为了行，将行转换为了列。

Membership

名称 描述
Table.Contains 确定记录是否显示为表中的一行。
Table.ContainsAll 确定所有指定的记录是否显示为表中的各行。
Table.ContainsAny 确定任何指定的记录是否显示为表中的各行。
Table.Distinct 删除表中的重复行，从而确保留下的所有行都是不同的。
Table.IsDistinct 确定表是否仅包含非重复行。
Table.PositionOf 确定行在表中的一个或多个位置。
Table.PositionOfAny 确定任何指定的行在表中的一个或多个位置。
Table.RemoveMatchingRows 从表中删除行的所有匹配项。
Table.ReplaceMatchingRows 使用新行替换表中的特定行。

中间件排序

名称 描述
Table.Max 使用 comparisonCriteria 返回表中的最大的行或最大的几行。
Table.MaxN 返回表中最大的 N 行。 对行进行排序后，必须指定 countOrCondition 参数以进一步筛选结果。
Table.Min 使用 comparisonCriteria 返回表中的最小的行或最小的几行。
Table.MinN 返回给定表中最小的 N 行。 对行进行排序后，必须指定 countOrCondition 参数以进一步筛选结果。
Table.AddRankColumn 追加一列，并使用一个或多个其他列进行排名。
Table.Sort 使用 comparisonCriteria 或默认顺序（若未指定）对表中的行进行排序。

其他

名称 描述
Table.Buffer 在内存中缓冲一个表，从而在计算期间将其与外部更改相隔离。

参数值

为输出列命名

此参数为文本值的一个列表，指定生成的表的列名。 此参数通常用在 Table 构造函数中，例如 Table.FromRows 和 Table.FromList。

比较条件

可将比较条件提供为以下值之一：

  • 用于指定排序顺序的一个数字值。 详细信息：排序顺序

  • 若要计算用于排序的键，可以使用具有 1 个参数的函数。

  • 若要选择键并控制顺序，比较条件可以是包含键和顺序的列表。

  • 若要完全控制比较，可以使用具有 2 个参数的函数，此函数将根据左输入和右输入之间的关系返回 -1、0 或 1。 Value.Compare 可用于委托此逻辑。

有关示例，请转到 Table.Sort 的说明。

Count 或 Condition 条件

此条件通常用于排序或行操作。 它确定表中返回的行数，并且可以采用数字或条件两种形式。

  • 数字指示适当函数中返回的值的数量。

  • 如果指定了条件，则返回包含的值最初满足条件的行。 一旦有一个值不符合条件，则不再考虑其他值。

详细信息：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 的说明。