Dela via


UPPVÄGA

Gäller för: Beräknad kolumn Beräknad tabell Mått Visuell beräkning

Returnerar en enskild rad som är placerad före eller efter den aktuella raden i samma tabell, med en given förskjutning. Om den aktuella raden inte kan härledas till en enskild rad kan flera rader returneras.

Syntax

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

Parametrar

Period Definition
delta Antalet rader före (negativt värde) eller efter (positivt värde) den aktuella rad som data ska hämtas från. Det kan vara alla DAX-uttryck som returnerar ett skalärt värde.
relation (Valfritt) Ett tabelluttryck som utdataraden returneras från.
Om det anges måste alla kolumner i <partitionBy> komma från den eller en relaterad tabell.
Om det utelämnas:
– <orderBy> måste anges uttryckligen.
– Alla <orderBy> - och <partitionBy-uttryck> måste vara fullständigt kvalificerade kolumnnamn och komma från en enda tabell.
– Standardvärdet är ALLSELECTED() för alla kolumner i <orderBy> och <partitionBy>.
axel (Valfritt) En axel i den visuella formen. Endast tillgängligt i visuella beräkningar och ersätter <relationen>.
orderBy (Valfritt) En ORDERBY()-sats som innehåller de uttryck som definierar hur varje partition sorteras.
Om det utelämnas:
– <måste relationen> uttryckligen anges.
– Standardinställningen är att sortera efter varje kolumn i <relation> som inte redan har angetts i <partitionBy>.
Blanksteg (Valfritt) En uppräkning som definierar hur tomma värden ska hanteras vid sortering.
Den här parametern är reserverad för framtida användning.
För närvarande är det enda värde som stöds STANDARD, där beteendet för numeriska värden är tomma värden sorteras mellan noll och negativa värden. Beteendet för strängar är tomma värden sorteras före alla strängar, inklusive tomma strängar.
partitionBy (Valfritt) En PARTITIONBY()-sats som innehåller kolumnerna som definierar hur <relationen> partitioneras.
Om den utelämnas <behandlas relationen> som en enda partition.
matchBy (Valfritt) En MATCHBY()-sats som innehåller kolumnerna som definierar hur du matchar data och identifierar den aktuella raden.
nollställa (Valfritt) Endast tillgängligt i visuella beräkningar. Anger om beräkningen återställs och på vilken nivå av den visuella formens kolumnhierarki. Godkända värden är: NONE, LOWESTPARENT, HIGHESTPARENT eller ett heltal. Beteendet beror på heltalstecknet:
– Om noll eller utelämnas återställs inte beräkningen. Motsvarar NONE.
– Om det är positivt identifierar heltal kolumnen med början från den högsta, oberoende av kornighet. HIGHESTPARENT motsvarar 1.
– Om det är negativt identifierar heltal kolumnen med början från den lägsta, i förhållande till det aktuella kornet. LOWESTPARENT motsvarar -1.

Returvärde

En eller flera rader från <relationen>.

Kommentarer

Förutom kolumner som läggs till av DAX-tabellfunktioner måste varje kolumn i <relation, när <matchBy> inte finns, eller varje kolumn i <matchBy> och <partitionBy>, när <matchBy> finns, ha ett motsvarande yttre värde för att definiera den aktuella raden som ska användas,> med följande beteende:

  • Om det finns exakt en motsvarande yttre kolumn används dess värde.
  • Om det inte finns någon motsvarande yttre kolumn:
    • OFFSET avgör först alla kolumner som inte har någon motsvarande yttre kolumn.
    • För varje kombination av befintliga värden för dessa kolumner i OFFSET:s överordnade kontext utvärderas OFFSET och en rad returneras.
    • OFFSET:s slutliga utdata är en union av dessa rader.
  • Om det finns mer än en motsvarande yttre kolumn returneras ett fel.

Om alla <relationers> kolumner har lagts till av DAX-tabellfunktioner returneras ett fel.

Om <matchBy> finns försöker OFFSET använda <kolumnerna matchBy> och <partitionBy> för att identifiera raden.
Om <matchBy> inte finns och kolumnerna som anges i <orderBy> och <partitionBy> inte unikt kan identifiera varje rad i <relation>:

  • OFFSET försöker hitta det minsta antal ytterligare kolumner som krävs för att unikt identifiera varje rad.
  • Om sådana kolumner kan hittas lägger OFFSET automatiskt till dessa nya kolumner i <orderBy>, och varje partition sorteras med den här nya uppsättningen OrderBy-kolumner.
  • Om det inte går att hitta sådana kolumner returneras ett fel.

En tom tabell returneras om:

  • Motsvarande yttre värde för en OrderBy- eller PartitionBy-kolumn finns inte i <relationen>.
  • Delta-värdet <> leder till en övergång till en rad som inte finns i partitionen.

Om OFFSET används i en beräknad kolumn som definierats i samma tabell som <relationen>, och <orderBy> utelämnas, returneras ett fel.

<reset> kan endast användas i visuella beräkningar och kan inte användas i kombination med <orderBy> eller <partitionBy>. Om <det finns en återställning> kan axeln> anges, <men <det går inte att göra det>.

Exempel 1 – beräknad kolumn

Följande DAX-fråga:

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]
    )
)

Returnerar en tabell som sammanfattar den totala försäljningen för varje produktkategori och kalenderår, samt den totala försäljningen för den kategorin under föregående år.

Exempel 2 – mått

Följande DAX-fråga:

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]
)

Använder OFFSET() i ett mått för att returnera en tabell som sammanfattar den totala försäljningen för varje kalenderår och den totala försäljningen för föregående år.

Exempel 3 – beräknad kolumn

Följande DAX-fråga:

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

Returnerar tabellen FactInternetSales med att lägga till en kolumn, vilket för varje försäljning anger dess tidigare försäljningsbelopp för samma produkt, i fallande försäljningsordning, där den aktuella försäljningen identifieras av dess SalesOrderNumber och SalesOrderLineNumber. Utan MATCHBY returnerar frågan ett fel eftersom det inte finns några nyckelkolumner i tabellen FactInternetSales.

Exempel 4 – visuell beräkning

Följande DAX-fråga för visuell beräkning:

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

Returnerar skillnaden i total försäljning mellan varje månad och den föregående inom samma år.

Skärmbilden nedan visar den visuella matrisen och det visuella beräkningsuttrycket:

Beräkning av visuella DAX-objekt

INDEX
ORDERBY
PARTITIONBY
MATCHBY
FÖNSTER
RANG
RADNUMMER