Элемент Name (ASSL)

Статья
05/08/2023

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

Синтаксис

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

Характеристики элемента

Характеристика	Описание
Тип данных и длина	String (до 100 символов)
Значение по умолчанию	Различается
Кратность	1-1: обязательный элемент, который выполняется только один раз

Связи элемента

Связь	Элемент
Родительские элементы	Действие, агрегирование, AggregationDesign, AlgorithmParameter, Аннотация, Сборка, ClrAssemblyFile, Cube, CubeDimension, CubeHierarchy, база данных, источник данных, представление DataSourceView, измерение, DimensionAttribute, Группа, Иерархия, ключевой показатель эффективности, уровень, MdxScript, мера, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, Секция, разрешение, Перспектива, PerspectiveCalculation, ReportFormatParameter, ReportParameter, роль, сервер, SERVERPROPERTY, Трассировка
Дочерние элементы	Нет

Связь

Элемент

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

Действие, агрегирование, AggregationDesign, AlgorithmParameter, Аннотация, Сборка, ClrAssemblyFile, Cube, CubeDimension, CubeHierarchy, база данных, источник данных, представление DataSourceView, измерение, DimensionAttribute, Группа, Иерархия, ключевой показатель эффективности, уровень, MdxScript, мера, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, Секция, разрешение, Перспектива, PerspectiveCalculation, ReportFormatParameter, ReportParameter, роль, сервер, SERVERPROPERTY, Трассировка

Дочерние элементы

Нет

Remarks

Каждый элемент, используемый для определения объекта (экземпляра Analysis Services, иерархии, атрибута и т. д.), имеет элемент Name в качестве свойства. Значение элемента Name имеет следующие ограничения.

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

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

Однако если задать свойство 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 в зависимости от родительского элемента.

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

См. также:

Элемент ID (ASSL)
Свойства (ASSL)

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