NAMEOF

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Retourne le nom d’une table, d’une colonne, d’une mesure ou d’un calendrier sous forme de chaîne de texte. Les paramètres facultatifs contrôlent le composant du nom retourné et la façon dont le résultat est échappé.

Syntaxe

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

Paramètres

Terme Definition
object Table, colonne, mesure ou calendrier dont vous souhaitez récupérer le nom.
component (Facultatif) Énumération qui spécifie la partie du nom qualifié à retourner. S’il est omis, la valeur par défaut est FULL. Consultez les valeurs du composant.
escaped (Facultatif) Énumération qui spécifie le mode d’échappement du nom retourné. S’il est omis, la valeur par défaut est ESCAPED. Consultez les valeurs d’échappement.

Valeurs des composants

Le paramètre component accepte les valeurs suivantes :

Valeur Description
TABLE Retourne le nom de la table. Retourne une erreur si l’objet n’est pas associé à une table (par exemple, un calendrier).
COLUMN Retourne le nom de la colonne. Retourne une erreur si l’objet n’est pas une colonne.
MEASURE Retourne le nom de la mesure. Retourne une erreur si l’objet n’est pas une mesure.
CALENDAR Retourne le nom du calendrier. Retourne une erreur si l’objet n’est pas un calendrier.
FULL (Par défaut) Retourne le nom complet de l’objet.
SELF Retourne le nom de l’objet lui-même : la colonne ou le nom de mesure pour les colonnes et les mesures, ou le nom de table/calendrier pour les tables et les calendriers.
PARENT Retourne le nom de la table parente pour les colonnes et les mesures. Retourne une erreur pour les tables et les calendriers.

Valeurs d’échappement

Le paramètre escaped accepte les valeurs suivantes :

Valeur Description
ESCAPED (Par défaut) Retourne le nom avec échappement complet DAX : noms de tables encapsulés entre guillemets simples, colonnes et noms de mesures encapsulés entre crochets.
UNESCAPED Retourne le nom brut sans délimiteurs ni caractères d’échappement. Retourne une erreur pour les noms complets qui contiennent à la fois un composant parent et enfant.
MINIMALLYESCAPED Retourne le nom avec échappement appliqué uniquement lorsque le nom l’exige. Les noms qui contiennent uniquement des lettres simples, des chiffres et des traits de soulignement sont retournés sans délimiteurs. Les noms qui contiennent des espaces ou des caractères spéciaux sont retournés avec échappement.

Valeur retournée

Chaîne de texte portant le nom demandé, mise en forme en fonction du composant et des paramètres d’échappement.

Remarques

  • Lorsqu’il est appelé uniquement avec l’argument object , NAMEOF se comporte de la même façon que dans les versions précédentes, en retournant un nom complet et placé en échappement. Étant donné que component les FULL valeurs par défaut sont et escaped les valeurs par défaut ESCAPED, les formats de retour sont les suivants :
    • Pour les tables : 'TableName'.
    • Pour les colonnes : 'TableName'[ColumnName].
    • Pour les mesures : 'TableName'[MeasureName].
    • Pour les calendriers : 'CalendarName'.
    • Pour les colonnes de variante : 'TableName'[ColumnName].[VariationName].
  • Les variables et les expressions dynamiques ne sont pas prises en charge en tant qu’arguments pour NAMEOF.
  • Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).

Comportement du composant par type d’entrée

Le tableau suivant montre le résultat de chaque component valeur pour différents types d’entrée, en utilisant le mode par défaut ESCAPED . « Erreur » indique que la combinaison retourne une erreur.

Type d’entrée TABLE COLUMN MEASURE CALENDAR FULL SELF PARENT
Colonne- Sales[Sales Amount] 'Sales' [Sales Amount] Error Error 'Sales'[Sales Amount] [Sales Amount] 'Sales'
Table- Sales 'Sales' Error Error Error 'Sales' 'Sales' Error
Mesure- Sales[m1] 'Sales' Error [m1] Error 'Sales'[m1] [m1] 'Sales'
Calendrier- myCalendar Error Error Error 'myCalendar' 'myCalendar' 'myCalendar' Error

Comportement d’échappement

Le escaped paramètre contrôle la façon dont le nom produit par l’étape component est mis en forme. Le tableau suivant utilise le nom entièrement placé en échappement comme référence et affiche la sortie de chaque escaped valeur.

Nom entièrement placé dans l’échappement ESCAPED UNESCAPED MINIMALLYESCAPED
'Sales' 'Sales' Sales Sales
'Sales'[Sales Amount] 'Sales'[Sales Amount] Error Sales[Sales Amount]
'Sales'[m1] 'Sales'[m1] Error Sales[m1]
[Amount] [Amount] Amount Amount
'Sales Region' 'Sales Region' Sales Region 'Sales Region'
'Sales Region'[Column] 'Sales Region'[Column] Error 'Sales Region'[Column]
[Order Quantity] [Order Quantity] Order Quantity [Order Quantity]

Note

UNESCAPED retourne une erreur pour les noms qualifiés complets (noms qui incluent à la fois une table et un composant colonne/mesure), car le résultat serait ambigu sans délimiteurs.

Règles d’échappement de caractères spéciaux

Les règles d’échappement suivantes s’appliquent dans DAX les délimiteurs de noms :

  • Noms de tables (délimités par un guillemet unique) : Un guillemet simple littéral (') dans un nom de table est placé sous forme d’échappement sous la forme de deux guillemets simples ('').
  • Noms de colonnes et de mesures (entre crochets délimités) : Un crochet fermant littéral (]) dans une colonne ou un nom de mesure est placé dans une séquence d’échappement en tant que ]]. Un crochet ouvrant ([) ne nécessite pas d’échappement.
Nom entièrement placé dans l’échappement ESCAPED UNESCAPED MINIMALLYESCAPED
'Ta''''ble' (table portant ' le nom) 'Ta''''ble' Ta''ble Ta''ble
[colu[]]mn] (colonne portant ] le nom) [colu[]]mn] colu[]mn [colu[]]mn]

Exemple 1

La requête suivante DAX retourne le nom complet d’une colonne :

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

Returns:

[Valeur]
'Sales'[Order Quantity]

Exemple 2

La requête suivante DAX retourne le nom complet d’une mesure :

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

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

Returns:

[Valeur]
'Sales'[Projected Sales]

Exemple 3

La requête suivante DAX utilise le component paramètre pour extraire uniquement le nom de la table d’une référence de colonne :

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

Returns:

[Valeur]
'Sales'

Exemple 4

La requête suivante DAX retourne un nom de table non boucté :

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

Returns:

[Valeur]
Sales

Exemple 5

La requête suivante DAX utilise les paramètres et escaped les component paramètres pour retourner le nom de la table parente à échappement minimale d’une colonne :

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

Returns:

[Valeur]
Sales

Contenu connexe

  • fonctions d’informations
  • Last updated on