Élément Name (ASSL)
Contient le nom de l'élément parent.
Syntaxe
<Action> <!-- or one of the elements listed below in the Element Relationships table -->
...
<Name>...</Name>
...
</Action>
Caractéristiques de l'élément
| Caractéristique | Description |
|---|---|
| Type de données et longueur | Chaîne (jusqu'à 100 caractères) |
| Valeur par défaut | Variable |
| Cardinalité | 1-1 : élément requis qui se produit une fois et une seule |
Relations entre les éléments
| Relation | Élément |
|---|---|
| Éléments parents | Action, agrégation, AggregationDesign, AlgorithmParameter, annotation, assembly, ClrAssemblyFile, cube, CubeDimension, CubeHierarchy, base de données, DataSource, DataSourceView, dimension, DimensionAttribute, groupe, hiérarchie, KPI, Level, MdxScript, measure, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, partition, autorisation, perspective, PerspectiveCalculation, ReportFormatParameter, ReportParameter, role, Server, ServerProperty, trace |
| Éléments enfants | None |
Remarques
Chaque élément utilisé pour définir un objet (une instance de Analysis Services, une hiérarchie, un attribut, etc.) a un élément Name comme propriété. La valeur d’un élément Name est soumise aux restrictions suivantes :
La valeur ne peut pas contenir des espaces de début ni de fin. Si des espaces de début ou de fin sont inclus dans la valeur d’un élément Name , ces espaces sont supprimés implicitement byAnalysis services.
La valeur ne doit pas contenir de caractères de contrôle. La présence de caractères de contrôle dans le nom est donc fortement déconseillée et peut parfois provoquer des erreurs de validation XML.
pour les objets créés à l’aide de la méthode GetNewName dans SQL Server, AMO recherche et supprime ensuite les caractères de contrôle, les espaces de début ou les espaces de fin dans le nom. Pour cette raison, l’utilisation de GetNewName est l’approche recommandée pour définir des noms d’objets.
Toutefois, si vous définissez directement la propriété Name , les mêmes contrôles de validation ne sont pas effectués, ce qui peut entraîner des erreurs de validation XML. Une erreur se produit en fonction du caractère de contrôle présent dans le nom.
Bien que les caractères de contrôle ne doivent jamais être utilisés dans un nom d'objet, Analysis Services ne les empêche pas expressément. Les versions antérieures d'Analysis Services autorisaient parfois des caractères de contrôle dans un nom d'objet. c’est la raison pour laquelle SQL Server 2016 Analysis Services et versions ultérieures ignorent les caractères de contrôle dans un nom d’objet pour éviter de rompre les anciennes solutions.
Les valeurs réservées suivantes ne peuvent pas être utilisées :
AUX
CLOCK$
COM1 à COM9 (COM1, COM2, COM3, et ainsi de suite)
CON
LPT1 à LPT9 (LPT1, LPT2, LPT3, et ainsi de suite)
NUL
PRN
Le tableau suivant répertorie les caractères supplémentaires qui ne peuvent pas être utilisés dans la valeur d’un élément Name , en fonction de l’élément parent.
| Élément parent | Caractères non valides |
|---|---|
| Serveur | le nom doit respecter les règles pour Windows noms d’ordinateurs. Les adresses IP ne sont pas valides. |
| DataSource | :/\\*|?"()[]{}<> ` |
| Level, élément Attribute | .,;':/\\*|?"&%$!+=[]{}<> ` |
| Tous les autres éléments parents | .,;':/\\*|?"&%$!+=()[]{}<> ` |