表函数

这些函数用于创建和操作表格值。

表构造

名称 DESCRIPTION
#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)捕获。

转换

名称 DESCRIPTION
Table.ToColumns 创建一个从表中获取列值的嵌套列表集合。
Table.ToList 通过将指定的组合函数应用于表中的每一行值,将表转换为列表。
Table.ToRecords 将表转换为记录列表。
Table.ToRows 从表中创建由行值组成的嵌套列表列表。

信息

名称 DESCRIPTION
Table.ApproximateRowCount 返回表中的大致行数。
Table.ColumnCount 返回表中的列数。
Table.IsEmpty 指示表是否包含任何行。
Table.PartitionValues 返回有关如何对表进行分区的信息。
Table.Profile 返回表列的概要信息。
Table.RowCount 返回表中的行数。
Table.Schema 返回一个表,其中包含指定表的列(即架构)的说明。
Tables.GetRelationships 获取一组表之间的关系。

行操作

名称 DESCRIPTION
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 返回一个列表,其中包含指定的第一个计数行和剩余行。

列操作

名称 DESCRIPTION
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 将指定集以外的所有列转换为属性值对。

转型

名称 DESCRIPTION
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 将上一个单元格的值传播到列中下面的空值单元格。
Table.FillUp 将单元格的值填充到列中上方的空值单元格。
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 将列转换为行,并将行转换为列。

会员资格

名称 DESCRIPTION
Table.Contains 指示指定的记录是否显示为表中的行。
Table.ContainsAll 指示所有指定记录是否显示为表中的行。
Table.ContainsAny 指示任何指定的记录是否显示为表中的行。
Table.Distinct 从表中删除重复的行。
Table.IsDistinct 指示表是否仅包含非重复行(无重复项)。
Table.PositionOf 返回表中行的位置或位置。
Table.PositionOfAny 返回表中任何指定行的位置或位置。
Table.RemoveMatchingRows 从表中删除所有指定的行。
Table.ReplaceMatchingRows 将所有指定的行替换为提供的行或行。

订购

名称 DESCRIPTION
Table.AddRankColumn 追加一个列,其中包含一个或多个其他列的排名。
Table.Max 使用给定条件返回最大行或默认值。
Table.MaxN 返回满足给定条件的最大的一行或多行。
Table.Min 使用给定条件返回最小行或默认值。
Table.MinN 返回满足给定条件的最小行。
Table.Sort 使用一个或多个列名和比较条件对表进行排序。

其他

名称 DESCRIPTION
Table.Buffer 在内存中缓冲表,在评估期间将其与外部更改隔离。
Table.StopFolding 阻止任何下游数据操作被运行在原始数据源上。

参数值

命名输出列

此参数是一个文本值列表,用于指定生成的表的列名。 此参数通常用于 表构造函数,例如 Table.FromRowsTable.FromList

比较条件

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

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

  • 若要计算要用于排序的键,可以使用一个参数的函数。

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

  • 若要完全控制比较,可以使用两个参数的函数,该函数返回 -1、0 或 1,给定左右输入之间的关系。 Value.Compare 可用于委托此逻辑。

示例请查看Table.Sort的说明。

计数或条件标准

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

  • 一个数字指示要通过适当的函数返回多少个值。

  • 如果指定了条件,则返回最初满足条件的值的行。 一旦某个值不符合条件,后续值将不再被考虑。

详细信息: Table.FirstNTable.MaxN

处理多余的值

额外值用于指示函数如何处理行中的额外值。 此参数指定为数字,该数字映射到以下选项:

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

详细信息: Table.FromListExtraValues.Type

缺少列处理

此参数用于指示函数如何处理缺失列。 此参数指定为数字,该数字映射到以下选项:

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

此参数用于列操作或转换操作,例如在 Table.TransformColumns 中。 详细信息:MissingField.Type

排序方式

排序顺序用于指示结果的排序方式。 此参数指定为数字,该数字映射到以下选项:

Order.Ascending = 0
Order.Descending = 1

详细信息:Order.Type

相等条件

可以将表的公式条件指定为以下任一项:

  • 一个函数值可能是以下之一:

    • 一个关键选择器,用于在表中确定要应用相等条件的列。

    • 用于指定要应用的比较类型的比较器函数。 可以指定内置比较器函数。 详细信息: 比较器函数

  • 表中需应用相等条件的列列表。

示例请查看Table.Distinct的说明。