OFFSET

适用于:计算列计算表度量值视觉计算

返回一行,该行位于同一表中 当前行 之前或之后,按给定的偏移量。 如果无法将当前行推断为单个行,可能会返回多个行。

语法

OFFSET ( <delta>[, <relation> or <axis>][, <orderBy>][, <blanks>][, <partitionBy>][, <matchBy>][, <reset>] )

参数

术语 定义
delta 要从中获取数据的当前行之前(负值)或(正值)之前的行数。 它可以是返回标量值的任何 DAX 表达式。
relation (可选)从中返回输出行的表表达式。
如果指定,partitionBy 中的所有列都必须来自它或相关表。
如果省略:必须显式指定
- orderBy
- 所有 orderBypartitionBy 表达式都必须是完全限定的列名,并且来自单个表。
- 默认为 orderBypartitionBy中的所有列的 ALLSELECTED()。
axis (可选)视觉形状中的轴。 仅在视觉计算中可用,并替换 relation
orderBy (可选)包含定义每个分区排序方式的表达式的 ORDERBY() 子句。
如果省略:必须显式指定
- relation
- 默认为 relation 中尚未在 partitionBy中指定的每一列排序。
blanks (可选)一个枚举,用于定义在对 relationaxis进行排序时如何处理空值。
支持的值为:
  • DEFAULT(默认值),其中数值的行为为空值,在零值和负值之间排序。 字符串的行为是空值在所有字符串(包括空字符串)之前排序。
  • FIRST,无论升序或降序排序顺序如何,空白始终在开头排序。
  • LAST,无论升序还是降序排序顺序,始终在末尾对空白进行排序。

注意,如果同时指定 ORDERBY() 函数中的 blanks 参数和空值,则单个 orderBy 表达式上的 blanks 优先于相关 orderBy 表达式,而未指定 blanks orderBy 表达式将遵循父函数上的 blanks 参数。
partitionBy (可选)PARTITIONBY() 子句,其中包含定义如何对 relation 进行分区的列。 如果省略,则 relation 被视为单个分区。
matchBy (可选)MATCHBY() 子句,其中包含定义如何匹配数据和标识当前行的列。
reset (可选)仅在视觉计算中可用。 指示计算是否重置,以及视觉形状的列层次结构的哪个级别。 接受的值包括:对当前视觉形状、NONE(默认值)、LOWESTPARENTHIGHESTPARENT或整数中的列的字段引用。 此行为取决于整数符号:
- 如果为零或省略,则计算不会重置。 等效于 NONE
- 如果为正值,则整数标识从最高、与粒度无关的列。 HIGHESTPARENT 等效于 1。
- 如果为负数,则整数标识从最低到当前粒度的列。 LOWESTPARENT 等效于 -1。

返回值

来自 relation的一行或多行。

言论

除了由 DAX 表函数添加的列、relation中的每个列、matchBy 不存在时,或者 matchBypartitionBy中的每个列(如果存在 matchBy),必须具有相应的外部值,以帮助定义要对其操作的当前行,并具有以下行为:

  • 如果正好有一个对应的外部列,则使用其值。
  • 如果没有相应的外部列,则:
    • OFFSET 首先确定没有相应外部列的所有列。
    • 对于 OFFSET父上下文中这些列的现有值的每个组合,将计算 OFFSET 并返回一行。
    • OFFSET的最终输出是这些行的联合。
  • 如果有多个相应的外部列,则返回错误。

如果 DAX 表函数添加了所有 relation列,则返回错误。

如果存在 matchBy,OFFSET 将尝试使用 matchBypartitionBy 列来标识行。 如果 matchBy 不存在,并且 orderBy 中指定的列和 partitionBy 无法唯一标识 relation中的每一行,则:

  • OFFSET 将尝试查找唯一标识每行所需的最少列数。
  • 如果可以找到此类列,OFFSET 将自动将这些新列追加到 orderBy,并且每个分区都使用此新的 OrderBy 列集进行排序。
  • 如果找不到此类列,则返回错误。

如果:

  • OrderBy 或 PartitionBy 列的相应外部值不存在于 relation中。
  • delta 值会导致转移到分区中不存在的行。

如果在与 relation相同的表上定义的计算列中使用 OFFSET,并且省略 orderBy,则返回错误。

reset 只能用于视觉计算,不能与 orderBypartitionBy结合使用。 如果存在 reset,则可以指定 axis,但无法指定 relation

示例 1 - 计算列

以下 DAX 查询:

DEFINE
VAR vRelation = SUMMARIZECOLUMNS ( 
                    DimProductCategory[EnglishProductCategoryName], 
                    DimDate[CalendarYear], 
                    "CurrentYearSales", SUM(FactInternetSales[SalesAmount]) 
                  )
EVALUATE
ADDCOLUMNS (
    vRelation, 
    "PreviousYearSales", 
    SELECTCOLUMNS(
        OFFSET ( 
                -1, 
                vRelation, 
                ORDERBY([CalendarYear]), 
                PARTITIONBY([EnglishProductCategoryName])
        ),
        [CurrentYearSales]
    )
)

返回一个表,该表汇总了每个产品类别和日历年的总销售额,以及上一年该类别的总销售额。

示例 2 - 度量值

以下 DAX 查询:

DEFINE
MEASURE DimProduct[CurrentYearSales] = SUM(FactInternetSales[SalesAmount])
MEASURE DimProduct[PreviousYearSales] = CALCULATE(SUM(FactInternetSales[SalesAmount]), OFFSET(-1, , ORDERBY(DimDate[CalendarYear])))
EVALUATE
SUMMARIZECOLUMNS (
    DimDate[CalendarYear],
    "CurrentYearSales", DimProduct[CurrentYearSales],
    "PreviousYearSales", DimProduct[PreviousYearSales]
)

在度量值中使用 OFFSET() 返回一个表,该表汇总了每个日历年的总销售额和上一年的总销售额。

示例 3 - 计算列

以下 DAX 查询:

EVALUATE
ADDCOLUMNS (
    FactInternetSales,
    "Previous Sales Amount",
        SELECTCOLUMNS (
            OFFSET (
                -1,
                FactInternetSales,
                ORDERBY ( FactInternetSales[SalesAmount], DESC ),
                PARTITIONBY ( FactInternetSales[ProductKey] ),
                MATCHBY( FactInternetSales[SalesOrderNumber], FactInternetSales[SalesOrderLineNumber] )
            ),
            FactInternetSales[SalesAmount]
        )
)

返回 FactInternetSales 表,其中添加了一列,该列指示每个销售的同一产品的上一次销售金额(按销售金额的降序排列),当前销售由 SalesOrderNumber 和 SalesOrderLineNumber 标识。 如果没有 MATCHBY,查询将返回错误,因为 FactInternetSales 表中没有键列。

示例 4 - 视觉计算

以下视觉计算 DAX 查询:

SalesRelativeToPreviousMonth = [SalesAmount] - CALCULATE(SUM([SalesAmount]), OFFSET(-1, ROWS, HIGHESTPARENT))

返回同一年内每个月和上一年的总销售额差异。

下面的屏幕截图显示了视觉矩阵和视觉计算表达式:

DAX 视觉计算

INDEX ORDERBY PARTITIONBY MATCHBY WINDOW RANK ROWNUMBER