Name 요소(ASSL)

  • 아티클

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

구문

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

요소 특징

특성 Description
데이터 형식 및 길이 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
자식 요소 없음

설명

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

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

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

    SQL Server GetNewName 메서드를 사용하여 만든 개체의 경우 AMO는 이름에서 컨트롤 문자, 선행 공백 또는 후행 공백을 확인하고 제거합니다. 이러한 이유로 GetNewName 을 사용하는 것이 개체 이름을 설정하는 데 권장되는 방법입니다.

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

    개체 이름에 제어 문자를 사용하지 않아야 하지만 Analysis Services에서는 이를 명시적으로 금지하지는 않습니다. 이전 버전의 Analysis Services에서는 때에 따라 개체 이름에 제어 문자를 허용했습니다. 이러한 이유로 SQL Server 2016 Analysis Services 이상에서는 개체 이름의 컨트롤 문자를 무시하여 이전 솔루션이 중단되지 않도록 합니다.

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

    • AUX

    • CLOCK$

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

    • CON

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

    • NUL

    • PRN

다음 표에서는 부모 요소에 따라 Name 요소의 값 내에서 사용할 수 없는 추가 문자를 나열합니다.

부모 요소 잘못된 문자
서버 이름은 Windows 컴퓨터 이름에 대한 규칙을 따라야 합니다. IP 주소는 유효하지 않습니다.
DataSource :/\\*&#124;?"()[]{}<> `
Level, Attribute 요소 .,;':/\\*&#124;?"&%$!+=[]{}<> `
기타 모든 부모 요소 .,;':/\\*&#124;?"&%$!+=()[]{}<> `

참고 항목

ID 요소(ASSL)
속성(ASSL)