Элемент Name (ASSL)

Статья
10/02/2012

Содержит имя родительского элемента.

Синтаксис

<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
Дочерние элементы	Нет

Родительские элементы

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.

Для объектов, созданных с помощью метода GetNewName в SQL Server 2012, объекты AMO проверяют, а затем удаляют в имени все управляющие символы, начальные или конечные пробелы. По этой причине использование GetNewName рекомендуется для задания имен объектов.

Однако, если задать свойство Name напрямую, такая проверка не выполняется, что может привести к ошибкам проверки XML. Зависит ли появление ошибки от того, какой управляющий символ встречается в имени.

Хотя управляющие символы вообще не следует использовать в имени объекта, службы Analysis Services не препятствуют этому в явной форме. Предыдущие выпуски служб Analysis Services иногда допускали управляющие символы в имени объекта. По этой причине SQL Server 2012 Analysis Services (SSAS) пропускает управляющие символы в имени объекта, чтобы избежать нарушения работы старых решений.
Нельзя использовать следующие зарезервированные значения:
- AUX
- CLOCK$
- COM1–COM9 (COM1, COM2, COM3 и т. д.)
- CON
- LPT1-LPT9 (LPT1, LPT2, LPT3 и т. д.)
- NUL
- PRN

В следующей таблице перечислены дополнительные символы, которые нельзя использовать в значении элемента Name, в зависимости от родительского элемента.

Родительский элемент	Недопустимые символы
Сервер	Имя должно соответствовать правилам именования для компьютеров Microsoft Windows. IP-адреса недопустимы.
DataSource	:/\*\|?"()[]{}<>
Level, Attribute Element	.,;'`:/\*\|?"&%$!+=[]{}<>
Все остальные родительские элементы	.,;'`:/\*\|?"&%$!+=()[]{}<>

См. также

Справочник

Элемент ID (ASSL)

Свойства (ASSL)

Поделиться через