Name 요소(ASSL)

  • 아티클

부모 요소의 이름을 포함합니다.

구문

<Action> <!-- or one of the elements listed below in the Element Relationships table -->
   ...
   <Name>...</Name>
   ...
</Action>

요소 특징

특징

설명

데이터 형식 및 길이

String(최대 100자)

기본값

상황에 따라 다름

카디널리티

1-1: 한 번만 나타나는 필수 요소입니다.

요소 관계

관계

요소

부모 요소

Action, Aggregation, AggregationDesign, AlgorithmParameter, Annotation, Assembly, ClrAssemblyFile, Cube, CubeDimension, CubeHierarchy, Database, DataSource, DataSourceView, Dimension, DimensionAttribute, Group, Hierarchy, Kpi, Level, MdxScript, Measure, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, Partition, Permission, Perspective, PerspectiveCalculation, ReportFormatParameter, ReportParameter, Role, Server, ServerProperty, Trace

자식 요소

없음

주의

개체를 정의하는 데 사용되는 모든 요소(Microsoft SQL Server Analysis Services 인스턴스, 계층, 특성 등)는 속성으로 Name 요소를 가집니다. Name 요소 값에는 다음과 같은 제한 사항이 있습니다.

  • 값은 선행 공백이나 후행 공백을 포함할 수 없습니다. Name 요소 값에 선행 공백이나 후행 공백이 포함될 경우 이러한 공백은 Analysis Services에 의해 암시적으로 제거됩니다.

  • 값에 제어 문자가 포함되어서는 안 됩니다. 이름에는 제어 문자가 없는 것이 좋습니다. 제어 문자가 있으면 XML 유효성 검사 오류가 발생할 수 있습니다.

    SQL Server 2012에서 GetNewName 메서드를 사용하여 만든 개체의 경우 AMO는 이름에서 제어 문자, 선행 공백 또는 후행 공백을 검사한 후 제거합니다. 따라서 개체 이름을 설정할 때에는 GetNewName을 사용하는 것이 좋습니다.

    그러나 Name 속성을 직접 설정하는 경우 XML 유효성 검사 오류가 발생할 수 있으므로 동일한 유효성 검사는 수행되지 않습니다. 오류가 실제로 발생하는지 여부에 따라 이름에 나타나는 제어 문자가 달라집니다.

    개체 이름에 제어 문자를 사용하지 않아야 하지만 Analysis Services에서는 이를 명시적으로 금지하지는 않습니다. 이전 버전의 Analysis Services에서는 때에 따라 개체 이름에 제어 문자를 허용했습니다. 따라서 이전 솔루션을 위반하지 않기 위해 SSAS(SQL Server 2012 Analysis Services)는 개체 이름에서 제어 문자를 무시합니다.

  • 예약된 다음 값은 사용할 수 없습니다.

    • AUX

    • CLOCK$

    • COM1 - COM9(COM1, COM2, COM3 등)

    • CON

    • LPT1 - LPT9(LPT1, LPT2, LPT3 등)

    • NUL

    • PRN

다음 표에서는 부모 요소에 따라 Name 요소 값으로 사용할 수 없는 추가 문자를 보여 줍니다.

부모 요소

잘못된 문자

Server

이 이름은 Microsoft Windows 컴퓨터 이름 규칙을 따라야 합니다. IP 주소는 유효하지 않습니다.

DataSource

:/\*|?"()[]{}<>

Level, Attribute 요소

.,;'`:/\*|?"&%$!+=[]{}<>

기타 모든 부모 요소

.,;'`:/\*|?"&%$!+=()[]{}<>

참고 항목

참조

ID 요소(ASSL)

속성(ASSL)