Élément Name (ASSL)

Article
05/08/2023

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

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	`.,;':/\\*\|?"&%$!+=()[]{}<>` `

Voir aussi

Élément ID (ASSL)
Propriétés (ASSL)

Partager via