NAMEOF

적용 대상:계산 열계산 테이블측정값시각적 계산

표, 열, 측정값 또는 달력의 이름을 텍스트 문자열로 반환합니다. 선택적 매개 변수는 반환되는 이름의 구성 요소와 결과를 이스케이프하는 방법을 제어합니다.

문법

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

매개 변수

용어 Definition
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에 대한 인수로 지원되지 않습니다.
  • 이 함수는 계산 열 또는 RLS(행 수준 보안) 규칙에서 사용되는 경우 DirectQuery 모드에서 사용할 수 없습니다.

입력 형식별 구성 요소 동작

다음 표에서는 기본 ESCAPED 모드를 사용하여 다양한 입력 형식에 대한 각 component 값의 결과를 보여줍니다. "오류"는 조합이 오류를 반환했음을 나타냅니다.

입력 유형 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] ) }

반환 값:

[값]
'Sales'[Order Quantity]

예제 2

다음 DAX 쿼리는 측정값의 정규화된 이름을 반환합니다.

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

EVALUATE
{ NAMEOF ( [Projected Sales] ) }

반환 값:

[값]
'Sales'[Projected Sales]

예제 3

다음 DAX 쿼리는 매개 변수를 component 사용하여 열 참조에서 테이블 이름만 추출합니다.

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

반환 값:

[값]
'Sales'

예제 4

다음 DAX 쿼리는 이스케이프되지 않은 테이블 이름을 반환합니다.

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

반환 값:

[값]
Sales

예제 5

다음 DAX 쿼리는 열의 component 최소 이스케이프된 부모 테이블 이름을 반환하기 위해 및 escaped 매개 변수를 사용합니다.

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

반환 값:

[값]
Sales

관련 콘텐츠

  • Last updated on