Name-Element (ASSL)
Enthält den Namen des übergeordneten Elements.
Syntax
<Action> <!-- or one of the elements listed below in the Element Relationships table -->
...
<Name>...</Name>
...
</Action>
Elementmerkmale
| Merkmal | BESCHREIBUNG |
|---|---|
| Datentyp und -länge | Zeichenfolge (bis zu 100 Zeichen) |
| Standardwert | Varies |
| Kardinalität | 1-1: Erforderliches Element, das nur einmal auftritt |
Elementbeziehungen
| Beziehung | Element |
|---|---|
| Übergeordnete Elemente | 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 |
| Untergeordnete Elemente | Keine |
Bemerkungen
Jedes Element, das zum Definieren eines Objekts verwendet wird (eine Instanz von Analysis Services, eine Hierarchie, ein Attribut usw.), verfügt über ein Name-Element als Eigenschaft. Der Wert eines Name -Elements hat die folgenden Einschränkungen:
Der Wert darf keine führenden oder nachgestellten Leerzeichen enthalten. Wenn führende oder nachfolgende Leerzeichen im Wert eines Name-Elements enthalten sind, werden diese Leerzeichen implizit vonAnalysis Services entfernt.
Der Wert sollte keine Steuerzeichen enthalten. Es wird dringend von Steuerzeichen in einem Namen abgeraten, da dies in einigen Fällen zu XML-Überprüfungsfehlern führen kann.
Für Objekte, die mit der GetNewName-Methode in SQL Server erstellt wurden, sucht AMO nach Steuerzeichen, führenden Leerzeichen oder nachgestellten Leerzeichen im Namen und entfernt diese anschließend. Aus diesem Grund wird empfohlen, GetNewName zum Festlegen von Objektnamen zu verwenden.
Beim direkten Festlegen der Name -Eigenschaft werden jedoch nicht die gleichen Überprüfungen ausgeführt, was zu XML-Überprüfungsfehlern führen kann. Ob ein Fehler tatsächlich auftritt, hängt davon ab, welches Steuerzeichen im Namen vorkommt.
Obwohl in Objektnamen grundsätzlich auf Steuerzeichen verzichtet werden sollte, wird deren Verwendung von Analysis Services nicht ausdrücklich untersagt. Von früheren Analysis Services-Versionen wurden manchmal Steuerzeichen in Objektnamen akzeptiert. Aus diesem Grund ignoriert SQL Server 2016 Analysis Services und höher Steuerzeichen in einem Objektnamen, um zu vermeiden, dass ältere Lösungen unterbrochen werden.
Die folgenden reservierten Werte können nicht verwendet werden:
AUX
CLOCK$
COM1 bis COM9 (COM1, COM2, COM3 usw.)
CON
LPT1 bis LPT9 (LPT1, LPT2, LPT3 usw.)
NUL
PRN
Die folgende Tabelle führt zusätzliche Zeichen auf, die abhängig vom übergeordneten Element nicht im Wert eines Name -Elements verwendet werden können.
| Übergeordnetes Element | Ungültige Zeichen |
|---|---|
| Server | Der Name muss den Regeln für Windows Computernamen entsprechen. IP-Adressen sind nicht gültig. |
| DataSource | :/\\*|?"()[]{}<> ` |
| Level, Attribute Element | .,;':/\\*|?"&%$!+=[]{}<> ` |
| Alle anderen übergeordneten Elemente | .,;':/\\*|?"&%$!+=()[]{}<> ` |