SAMPLE 函数 (DAX)

从指定的表中返回一个包含 N 行的示例。

语法

SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])

参数

• n_value
  要返回的行数。 它是任何返回单个标量值的 DAX 表达式，其中，表达式将计算多次（针对每行/上下文）。 如果输入了非整数值（或表达式），结果将转换为整数。

• table
  任意 DAX 表达式，返回将从中提取这“n”行示例的数据表。

• orderBy_expression
  （可选）任意标量 DAX 表达式，将针对 table 的每一行计算结果值。

• order
  （可选）一个值，指定如何对 orderBy_expression 值排序（按升序或降序）：

  值	备选值	说明
  0（零）	FALSE	按降序对 order_by 的值排序。 当忽略 order 参数时，这是默认值。
  1	TRUE	按 order_by 的升序进行排名。

返回值

一个表，其中是包含 table 中 N 行的示例；如果 n_value 为 0（零）或更小，则为空表。 如果提供了 OrderBy 参数，该示例将具有稳定性和确定性，即返回第一行、最后一行，以及它们之间平均分布的各行。 如果未指定排序，示例将是随机的，不具有稳定性和确定性。

注释

• 如果 n_value 为 0（零）或更小，则 SAMPLE 将返回一个空表。

• 为避免在示例中出现重复值，作为第二个参数提供的表应依据排序所用列进行分组。