Élément Name (ASSL)

  • Article

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 :/\\*&#124;?"()[]{}<> `
Level, élément Attribute .,;':/\\*&#124;?"&%$!+=[]{}<> `
Tous les autres éléments parents .,;':/\\*&#124;?"&%$!+=()[]{}<> `

Voir aussi

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