ΟΝΟΜΑ

Ισχύει για:Υπολογιζόμενη στήληΥπολογιζόμενος πίνακαςΜέτρηση υπολογισμού απεικόνισης

Επιστρέφει το όνομα ενός πίνακα, στήλης, μέτρησης ή ημερολογίου ως συμβολοσειρά κειμένου. Οι προαιρετικές παράμετροι ελέγχουν ποιο στοιχείο του ονόματος επιστρέφεται και τον τρόπο διαφυγής του αποτελέσματος.

Σύνταξη

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

Παράμετροι

Όρος Ορισμός
object Ο πίνακας, η στήλη, η μέτρηση ή το ημερολόγιο των οποίων το όνομα θέλετε να ανακτήσετε.
component (Προαιρετικό) Μια απαρίθμηση που καθορίζει ποιο τμήμα του προσδιορισμένου ονόματος θα επιστραφεί. Εάν παραλειφθεί, η προεπιλογή FULLείναι . Ανατρέξτε στο θέμα Τιμές στοιχείου.
escaped (Προαιρετικό) Μια απαρίθμηση που καθορίζει τον τρόπο διαφυγής του ονόματος που επιστρέφεται. Εάν παραλειφθεί, η προεπιλογή ESCAPEDείναι . Ανατρέξτε στο θέμα Τιμές διαφυγής.

Τιμές στοιχείου

Η παράμετρος component αποδέχεται τις ακόλουθες τιμές:

Τιμή Περιγραφή
TABLE Επιστρέφει το όνομα του πίνακα. Επιστρέφει ένα σφάλμα εάν το αντικείμενο δεν συσχετίζεται με έναν πίνακα (π.χ. ένα ημερολόγιο).
COLUMN Επιστρέφει το όνομα στήλης. Επιστρέφει ένα σφάλμα εάν το αντικείμενο δεν είναι στήλη.
MEASURE Επιστρέφει το όνομα μέτρησης. Επιστρέφει ένα σφάλμα εάν το αντικείμενο δεν είναι μέτρηση.
CALENDAR Επιστρέφει το όνομα του ημερολογίου. Επιστρέφει ένα σφάλμα εάν το αντικείμενο δεν είναι ημερολόγιο.
FULL (Προεπιλογή) Επιστρέφει το πλήρως προσδιορισμένο όνομα του αντικειμένου.
SELF Επιστρέφει το όνομα του ίδιου του αντικειμένου: το όνομα στήλης ή μέτρησης για στήλες και μετρήσεις ή το όνομα πίνακα/ημερολογίου για πίνακες και ημερολόγια.
PARENT Επιστρέφει το όνομα του γονικού πίνακα για στήλες και μετρήσεις. Επιστρέφει ένα σφάλμα για πίνακες και ημερολόγια.

Τιμές διαφυγής

Η παράμετρος escaped αποδέχεται τις ακόλουθες τιμές:

Τιμή Περιγραφή
ESCAPED (Προεπιλογή) Επιστρέφει το όνομα με πλήρη DAX διαφυγή: ονόματα πινάκων περιτυλιγμένα σε μονά εισαγωγικά, ονόματα στηλών και μετρήσεων σε αγκύλες.
UNESCAPED Επιστρέφει το ανεπεξέργαστα όνομα χωρίς οριοθέτες ή χαρακτήρες διαφυγής. Επιστρέφει ένα σφάλμα για πλήρως προσδιορισμένα ονόματα που περιέχουν ένα γονικό και θυγατρικό στοιχείο.
MINIMALLYESCAPED Επιστρέφει το όνομα με διαφυγή που εφαρμόζεται μόνο όταν το απαιτεί το όνομα. Τα ονόματα που περιέχουν μόνο απλά γράμματα, ψηφία και χαρακτήρες υπογράμμισης επιστρέφονται χωρίς οριοθέτες. Τα ονόματα που περιέχουν κενά διαστήματα ή ειδικούς χαρακτήρες επιστρέφονται με τη διαφυγή.

Τιμή επιστροφής

Μια συμβολοσειρά κειμένου με το ζητούμενο όνομα, μορφοποιημένη με βάση το στοιχείο και τις παραμέτρους διαφυγής.

Παρατηρήσεις

  • Όταν καλείται μόνο με το όρισμα, η object NAMEOF συμπεριφέρεται όμοια με τις προηγούμενες εκδόσεις, επιστρέφοντας ένα πλήρως προσδιορισμένο όνομα διαφυγής. Επειδή component η FULL προεπιλεγμένη τιμή και escaped η προεπιλεγμένη τιμή ESCAPEDείναι , οι μορφές επιστροφής είναι:
    • Για πίνακες: 'TableName'.
    • Για στήλες: 'TableName'[ColumnName].
    • Για μετρήσεις: 'TableName'[MeasureName].
    • Για ημερολόγια: 'CalendarName'.
    • Για στήλες παραλλαγών: 'TableName'[ColumnName].[VariationName].
  • Οι μεταβλητές και οι δυναμικές παραστάσεις δεν υποστηρίζονται ως ορίσματα στο NAMEOF.
  • Αυτή η συνάρτηση δεν υποστηρίζεται για χρήση σε λειτουργία DirectQuery όταν χρησιμοποιείται σε υπολογιζόμενες στήλες ή σε κανόνες ασφάλειας σε επίπεδο γραμμών (RLS).

Συμπεριφορά στοιχείου κατά τύπο εισόδου

Ο παρακάτω πίνακας εμφανίζει το αποτέλεσμα κάθε component τιμής για διαφορετικούς τύπους εισόδου, χρησιμοποιώντας την προεπιλεγμένη ESCAPED λειτουργία. Το "Error" υποδεικνύει ότι ο συνδυασμός επιστρέφει ένα σφάλμα.

Τύπος εισόδου TABLE COLUMN MEASURE CALENDAR FULL SELF PARENT
Στήλη- Sales[Sales Amount] 'Sales' [Sales Amount] Σφάλμα Σφάλμα 'Sales'[Sales Amount] [Sales Amount] 'Sales'
Πίνακα- Sales 'Sales' Σφάλμα Σφάλμα Σφάλμα 'Sales' 'Sales' Σφάλμα
Μέτρο- Sales[m1] 'Sales' Σφάλμα [m1] Σφάλμα 'Sales'[m1] [m1] 'Sales'
Ημερολόγιο- myCalendar Σφάλμα Σφάλμα Σφάλμα 'myCalendar' 'myCalendar' 'myCalendar' Σφάλμα

Συμπεριφορά διαφυγής

Η escaped παράμετρος ελέγχει τον τρόπο με τον οποίο μορφοποιείται το όνομα που παράγεται από το component βήμα. Ο παρακάτω πίνακας χρησιμοποιεί το πλήρες όνομα διαφυγής ως αναφορά και εμφανίζει την έξοδο για κάθε escaped τιμή.

Πλήρες όνομα διαφυγής ESCAPED UNESCAPED MINIMALLYESCAPED
'Sales' 'Sales' Sales Sales
'Sales'[Sales Amount] 'Sales'[Sales Amount] Σφάλμα Sales[Sales Amount]
'Sales'[m1] 'Sales'[m1] Σφάλμα Sales[m1]
[Amount] [Amount] Amount Amount
'Sales Region' 'Sales Region' Sales Region 'Sales Region'
'Sales Region'[Column] 'Sales Region'[Column] Σφάλμα 'Sales Region'[Column]
[Order Quantity] [Order Quantity] Order Quantity [Order Quantity]

Σημείωμα

UNESCAPED Η επιστρέφει ένα σφάλμα για πλήρως προσδιορισμένα ονόματα (ονόματα που περιλαμβάνουν τόσο έναν πίνακα όσο και ένα στοιχείο στήλης/μέτρησης), επειδή το αποτέλεσμα θα ήταν ασαφές χωρίς οριοθέτες.

Ειδικοί κανόνες διαφυγής χαρακτήρων

Οι ακόλουθοι κανόνες διαφυγής ισχύουν μέσα στους DAX οριοθέτες ονομάτων:

  • Ονόματα πίνακα (οριοθετημένα με μονά εισαγωγικά): Ένα μονό εισαγωγικό λεκτικής σταθεράς (') σε ένα όνομα πίνακα απέχει δύο μονά εισαγωγικά ('').
  • Ονόματα στηλών και μετρήσεων (οριοθετημένα με αγκύλη): Μια δεξιά αγκύλη λεκτικής σταθεράς (]) σε ένα όνομα στήλης ή μέτρησης διαφεύγει ως ]]. Η αριστερή αγκύλη ([) δεν απαιτεί διαφυγή.
Πλήρες όνομα διαφυγής ESCAPED UNESCAPED MINIMALLYESCAPED
'Ta''''ble' (πίνακας με ' το όνομα) 'Ta''''ble' Ta''ble Ta''ble
[colu[]]mn] (στήλη με ] όνομα) [colu[]]mn] colu[]mn [colu[]]mn]

Παράδειγμα 1

Το παρακάτω DAX ερώτημα επιστρέφει το πλήρως προσδιορισμένο όνομα μιας στήλης:

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

Επιστρέφει:

[Τιμή]
'Πωλήσεις'[Ποσότητα παραγγελίας]

Παράδειγμα 2

Το παρακάτω DAX ερώτημα επιστρέφει το πλήρως προσδιορισμένο όνομα μιας μέτρησης:

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

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

Επιστρέφει:

[Τιμή]
'Πωλήσεις'[Προβλεπόμενες πωλήσεις]

Παράδειγμα 3

Το παρακάτω DAX ερώτημα χρησιμοποιεί την component παράμετρο για την εξαγωγή μόνο του ονόματος πίνακα από μια αναφορά στήλης:

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

Επιστρέφει:

[Τιμή]
"Πωλήσεις"

Παράδειγμα 4

Το παρακάτω DAX ερώτημα επιστρέφει ένα όνομα πίνακα χωρίςκεφαλιά:

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

Επιστρέφει:

[Τιμή]
Πωλήσεις

Παράδειγμα 5

Το παρακάτω DAX ερώτημα χρησιμοποιεί τις component παραμέτρους και escaped για να επιστρέψει το ελάχιστο όνομα γονικού πίνακα διαφυγής μιας στήλης:

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

Επιστρέφει:

[Τιμή]
Πωλήσεις
  • συναρτήσεων πληροφοριών