OFFSET

Van toepassing op: Berekende kolomBerekende tabelMetingVisuele berekening

Retourneert één rij die is geplaatst vóór of na de huidige rij in dezelfde tabel, door een bepaalde offset. Als de huidige rij niet kan worden afgeleid van één rij, kunnen meerdere rijen worden geretourneerd.

Syntaxis

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

Parameters

Term	Definitie
delta	Het aantal rijen vóór (negatieve waarde) of na (positieve waarde) van waaruit de gegevens moeten worden opgehaald. Dit kan elke DAX-expressie zijn die een scalaire waarde retourneert.
Relatie	(Optioneel) Een tabelexpressie waaruit de uitvoerrij wordt geretourneerd. Indien opgegeven, moeten alle kolommen in <partitionBy> er vandaan komen of een gerelateerde tabel. Als u dit weglaat: - <orderBy> moet expliciet worden opgegeven. - Alle <orderBy> - en <partitionBy-expressies> moeten volledig gekwalificeerde kolomnamen zijn en afkomstig zijn van één tabel. - Standaard ingesteld op ALLSELECTED() van alle kolommen in <orderBy> en <partitionBy>.
as	(Optioneel) Een as in de visuele shape. Alleen beschikbaar in visuele berekeningen en vervangt <de relatie>.
Orderby	(Optioneel) Een ORDERBY()-component met de expressies die definiëren hoe elke partitie wordt gesorteerd. Als u dit weglaat: - <relatie> moet expliciet worden opgegeven. - Hiermee wordt standaard elke kolom gerangschikt in <relatie> die nog niet is opgegeven in <partitionBy>.
Blanks	(Optioneel) Een opsomming waarmee wordt gedefinieerd hoe lege waarden moeten worden verwerkt bij het sorteren. Deze parameter is gereserveerd voor toekomstig gebruik. Op dit moment is de enige ondersteunde waarde STANDAARD, waarbij het gedrag voor numerieke waarden lege waarden is tussen nul en negatieve waarden. Het gedrag voor tekenreeksen is lege waarden die vóór alle tekenreeksen worden geordend, inclusief lege tekenreeksen.
partitionBy	(Optioneel) Een PARTITIONBY()-component met de kolommen die definiëren hoe <relatie> wordt gepartitioneerd. Als u dit weglaat, <wordt de relatie> behandeld als één partitie.
matchBy	(Optioneel) Een MATCHBY()-component met de kolommen die bepalen hoe gegevens moeten worden vergeleken en de huidige rij moet worden geïdentificeerd.
opnieuw instellen	(Optioneel) Alleen beschikbaar in visuele berekeningen. Geeft aan of de berekening opnieuw wordt ingesteld en op welk niveau van de kolomhiërarchie van de visualshape. Geaccepteerde waarden zijn: NONE, LOWESTPARENT, HIGHESTPARENT of een geheel getal. Het gedrag is afhankelijk van het gehele getalteken: - Als nul of weggelaten wordt, wordt de berekening niet opnieuw ingesteld. Gelijk aan NONE. - Als positief, identificeert het gehele getal de kolom die begint vanaf het hoogste, onafhankelijk van de korrel. HIGHESTPARENT is gelijk aan 1. - Als dit negatief is, identificeert het gehele getal de kolom die begint vanaf het laagste getal, ten opzichte van de huidige korrel. LAAGSTEPARENT is gelijk aan -1.

Retourwaarde

Een of meer rijen uit <relatie>.

Opmerkingen

Met uitzondering van kolommen die door DAX-tabelfuncties worden toegevoegd, moet elke kolom in <relatie, wanneer <matchBy> niet aanwezig is, of elke kolom in <matchBy en <partitionBy>>, wanneer <matchBy> aanwezig is, een overeenkomstige buitenwaarde hebben om de huidige rij te definiëren waarop moet worden uitgevoerd, met> het volgende gedrag:

• Als er precies één corresponderende buitenkolom is, wordt de waarde ervan gebruikt.
• Als er geen overeenkomstige buitenste kolom is, gaat u als volgt te werk:
  • OFFSET bepaalt eerst alle kolommen die geen corresponderende buitenste kolom hebben.
  • Voor elke combinatie van bestaande waarden voor deze kolommen in de bovenliggende context van OFFSET wordt OFFSET geëvalueerd en wordt een rij geretourneerd.
  • De uiteindelijke uitvoer van OFFSET is een samenvoeging van deze rijen.
• Als er meer dan één corresponderende buitenkolom is, wordt er een fout geretourneerd.

Als alle kolommen van <relaties> zijn toegevoegd door DAX-tabelfuncties, wordt er een fout geretourneerd.

Als <matchBy> aanwezig is, probeert OFFSET matchBy>- en <partitionBy-kolommen> te gebruiken <om de rij te identificeren.
Als <matchBy> niet aanwezig is en de kolommen die zijn opgegeven in <orderBy> en <partitionBy> , kunnen niet elke rij in <relatie> uniek identificeren, dan:

• OFFSET probeert het minste aantal extra kolommen te vinden dat nodig is om elke rij uniek te identificeren.
• Als dergelijke kolommen kunnen worden gevonden, worden deze nieuwe kolommen automatisch toegevoegd aan <orderBy> en wordt elke partitie gesorteerd met behulp van deze nieuwe set OrderBy-kolommen.
• Als dergelijke kolommen niet kunnen worden gevonden, wordt er een fout geretourneerd.

Er wordt een lege tabel geretourneerd als:

• De overeenkomstige buitenwaarde van een kolom OrderBy of PartitionBy bestaat niet binnen <een relatie>.
• De <deltawaarde> veroorzaakt een verschuiving naar een rij die niet bestaat binnen de partitie.

Als OFFSET wordt gebruikt in een berekende kolom die is gedefinieerd in dezelfde tabel als <relatie> en <orderBy> wordt weggelaten, wordt een fout geretourneerd.

<reset> kan alleen worden gebruikt in visuele berekeningen en kan niet worden gebruikt in combinatie met <orderBy> of <partitionBy>. Als <het opnieuw instellen> aanwezig is, kan de as> worden opgegeven, <maar <niet de relatie>.

Voorbeeld 1: berekende kolom

De volgende DAX-query:

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

Retourneert een tabel met een overzicht van de totale verkoop voor elke productcategorie en elk kalenderjaar, evenals de totale verkoop voor die categorie in het vorige jaar.

Voorbeeld 2: meting

De volgende DAX-query:

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

Maakt gebruik van OFFSET() in een meting om een tabel te retourneren waarin de totale verkoop voor elk kalenderjaar en de totale verkoop voor het vorige jaar wordt samengevat.

Voorbeeld 3: berekende kolom

De volgende DAX-query:

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

Retourneert de tabel FactInternetSales met het toevoegen van een kolom, die aangeeft, voor elke verkoop, het bedrag van de vorige verkoop, van hetzelfde product, in aflopende volgorde van het verkoopbedrag, waarbij de huidige verkoop wordt geïdentificeerd door zijn SalesOrderNumber en SalesOrderLineNumber. Zonder MATCHBY retourneert de query een fout omdat er geen sleutelkolommen in de tabel FactInternetSales zijn.

Voorbeeld 4: visuele berekening

De volgende DAX-query voor visuele berekening:

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

Retourneert het verschil in de totale verkoop tussen elke maand en de vorige binnen hetzelfde jaar.

In de onderstaande schermopname ziet u de visualmatrix en de expressie voor de berekening van de visual:

Gerelateerde inhoud

INDEX
ORDERBY
PARTITIONBY
MATCHBY
VENSTER
RANG
RIJNUMMER