Jaa

NIMI

Koskee seuraavia:Laskettu sarakeLaskettu taulukkoMittayksikköVisuaalinen laskenta -

Palauttaa taulukon, sarakkeen, mittauksen tai kalenterin nimen tekstimerkkijonona. Valinnaiset parametrit määrittävät, mikä nimen osa palautetaan ja miten tulos on palautettu.

Syntax

NAMEOF ( <object> [, <component> [, <escaped>]] )

Parametrit

Termi Määritelmä
object Taulukko, sarake, mittari tai kalenteri, jonka nimen haluat noutaa.
component (Valinnainen) Luettelointi, joka määrittää, mikä osa hyväksytystä nimestä palautetaan. Jos tämä jätetään pois, oletusarvo on FULL. Katso Komponenttiarvot.
escaped (Valinnainen) Luettelointi, joka määrittää, miten palautettu nimi on karannut. Jos tämä jätetään pois, oletusarvo on ESCAPED. Katso Escaped-arvot.

Komponenttiarvot

component-parametri hyväksyy seuraavat arvot:

Arvo Description
TABLE Palauttaa taulukon nimen. Palauttaa virheen, jos objektia ei ole liitetty taulukkoon (esimerkiksi kalenteriin).
COLUMN Palauttaa sarakkeen nimen. Palauttaa virheen, jos objekti ei ole sarake.
MEASURE Palauttaa mittarin nimen. Palauttaa virheen, jos objekti ei ole mittari.
CALENDAR Palauttaa kalenterin nimen. Palauttaa virheen, jos objekti ei ole kalenteri.
FULL (Oletus) Palauttaa objektin täyteen nimeen.
SELF Palauttaa itse objektin nimen: sarakkeiden tai mittayksiköiden sarakkeen tai mittarin nimen tai taulukoiden ja kalenterien taulukon/kalenterin nimen.
PARENT Palauttaa sarakkeiden ja mittayksiköiden päätaulukon nimen. Palauttaa virheen taulukoille ja kalentereille.

Karanneet arvot

escaped-parametri hyväksyy seuraavat arvot:

Arvo Description
ESCAPED (Oletus) Palauttaa nimen käyttäen täyttä DAX ohjausmerkkiä: taulukoiden nimet, jotka on pakattu heittomerkkien sisään, sarakkeet ja mittayksikön nimet hakasulkeisiin käärittyinä.
UNESCAPED Palauttaa raakan nimen ilman erottimia tai ohjausmerkkejä. Palauttaa virheen täydellisille nimille, jotka sisältävät sekä pää- että alikomponentin.
MINIMALLYESCAPED Palauttaa nimen, jossa ohjauskoe on käytössä vain, kun nimi edellyttää sitä. Nimet, jotka sisältävät vain yksinkertaisia kirjaimia, numeroita ja alaviivoja, palautetaan ilman erottimia. Välilyöntejä tai erikoismerkkejä sisältävät nimet palautetaan ohjausmerkkien sisällä.

Palautusarvo

Tekstimerkkijono, jonka nimi on pyydetty ja joka on muotoiltu komponentin ja parametrien mukaisesti.

Huomautukset

  • Kun sitä kutsutaan vain object argumentilla, NAMEOF käyttäytyy samalla tavalla kuin aiemmissa versioissa ja palauttaa täyteen, karanneen nimen. Koska component oletusarvo on FULL ja escaped on ESCAPED, palautusmuodot ovat:
    • Taulukoille: 'TableName'.
    • Sarakkeille: 'TableName'[ColumnName].
    • Mittarit: 'TableName'[MeasureName].
    • Kalentereille: 'CalendarName'.
    • Muunnelmat-sarakkeet: 'TableName'[ColumnName].[VariationName].
  • Muuttujia ja dynaamisia lausekkeita ei tueta NAMEOF-funktion argumentteina.
  • Tätä funktiota ei tueta DirectQuery-tilassa lasketuissa sarakkeissa tai rivitason suojauksen (RLS) säännöissä käytettäväksi.

Osan toiminta syötetyypin mukaan

Seuraavassa taulukossa on esitetty eri syötetyyppien kunkin component arvon tulokset oletustilaa ESCAPED käyttäen. "Virhe" ilmaisee, että yhdistelmä palauttaa virheen.

Syötetyyppi TABLE COLUMN MEASURE CALENDAR FULL SELF PARENT
Sarake- Sales[Sales Amount] 'Sales' [Sales Amount] Virhe Virhe 'Sales'[Sales Amount] [Sales Amount] 'Sales'
Taulukossa- Sales 'Sales' Virhe Virhe Virhe 'Sales' 'Sales' Virhe
Toimenpide- Sales[m1] 'Sales' Virhe [m1] Virhe 'Sales'[m1] [m1] 'Sales'
Kalenteri- myCalendar Virhe Virhe Virhe 'myCalendar' 'myCalendar' 'myCalendar' Virhe

Karannut toiminta

escaped Parametri määrittää, miten vaiheen tuottama component nimi muotoillaan. Seuraavassa taulukossa käytetään viitteenä täysin karannutta nimeä ja näytetään kunkin escaped arvon tuloste.

Täysin karannut nimi ESCAPED UNESCAPED MINIMALLYESCAPED
'Sales' 'Sales' Sales Sales
'Sales'[Sales Amount] 'Sales'[Sales Amount] Virhe Sales[Sales Amount]
'Sales'[m1] 'Sales'[m1] Virhe Sales[m1]
[Amount] [Amount] Amount Amount
'Sales Region' 'Sales Region' Sales Region 'Sales Region'
'Sales Region'[Column] 'Sales Region'[Column] Virhe 'Sales Region'[Column]
[Order Quantity] [Order Quantity] Order Quantity [Order Quantity]

Muistio

UNESCAPED palauttaa virheen täydellisille nimille (nimet, jotka sisältävät sekä taulukon että sarakkeen/mittarin osan), koska tulos olisi moniselitteinen ilman erottimia.

Erikoismerkkien ohjaussäännöt

Seuraavat ohjaussäännöt ovat voimassa nimien erottimien sisällä DAX :

  • Taulukoiden nimet (erotinmerkkeillä eroteltu): Literaali heittomerkki (') taulukon nimessä poistetaan kahtena lainausmerkkinä ('').
  • Sarakkeiden ja mittayksiköiden nimet (hakasulkeen erotinmerkkejä): Literaalin sulkeva hakasulje (]) sarakkeessa tai mittayksikön nimessä poistetaan muodossa ]]. Avaava hakasulje ([) ei vaadi ohjausmerkkiä.
Täysin karannut nimi ESCAPED UNESCAPED MINIMALLYESCAPED
'Ta''''ble' (taulukko, jossa on ' nimi) 'Ta''''ble' Ta''ble Ta''ble
[colu[]]mn] (sarake, jonka ] nimi on) [colu[]]mn] colu[]mn [colu[]]mn]

Esimerkki 1

Seuraava DAX kysely palauttaa sarakkeen täyden nimen:

EVALUATE
{ NAMEOF ( 'Sales'[ORDER QUANTITY] ) }

Palauttaa:

[Value]
'Myynti'[Tilausmäärä]

Esimerkki 2

Seuraava DAX kysely palauttaa mittarin täysin hyväksytyn nimen:

DEFINE
    MEASURE Sales[Projected Sales] =
        SUM ( 'Sales'[Sales Amount] ) * 1.06

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

Palauttaa:

[Value]
'Myynti'[Ennustettu myynti]

Esimerkki 3

Seuraava DAX kysely poimii parametrin component avulla vain taulukon nimen sarakeviittausta:

EVALUATE
{ NAMEOF ( 'Sales'[Sales Amount], TABLE ) }

Palauttaa:

[Value]
Myynti

Esimerkki 4

Seuraava DAX kysely palauttaa tiivistämättömän taulukon nimen:

EVALUATE
{ NAMEOF ( 'Sales', FULL, UNESCAPED ) }

Palauttaa:

[Value]
Sales

Esimerkki 5

Seuraava DAX kysely käyttää - ja escaped -componentparametreja palauttamaan sarakkeesta osittain karanneen päätaulukon nimen:

EVALUATE
{ NAMEOF ( 'Sales'[Sales Amount], PARENT, MINIMALLYESCAPED ) }

Palauttaa:

[Value]
Sales

Liittyvä sisältö

  • Last updated on