Elemento Name (ASSL)
Contiene el nombre del elemento primario.
Sintaxis
<Action> <!-- or one of the elements listed below in the Element Relationships table -->
...
<Name>...</Name>
...
</Action>
Características del elemento
Característica |
Descripción |
|---|---|
Tipo y longitud de los datos |
Cadena (hasta 100 caracteres) |
Valor predeterminado |
Varía |
Cardinalidad |
1-1: Elemento necesario que se produce una vez y solo una vez. |
Relaciones del elemento
Relación |
Elemento |
|---|---|
Elementos primarios |
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 |
Elementos secundarios |
Ninguno |
Comentarios
Cada elemento que se utiliza para definir un objeto (una instancia de Microsoft SQL Server Analysis Services, una jerarquía, un atributo, etc.) tiene un elemento Name como propiedad. El valor de un elemento Name tiene las restricciones siguientes:
El valor no puede contener espacios delante ni detrás. Si se incluyen espacios al principio o al final del valor de un elemento Name, Analysis Services los quitará implícitamente.
El valor no debe contener caracteres de control. Se desaconseja la presencia de caracteres de control en un nombre, ya que a veces puede producir errores de validación XML.
Para los objetos creados mediante el método GetNewName en SQL Server 2012, AMO comprueba y posteriormente quita todos los caracteres de control, espacios iniciales o espacios finales del nombre. Por esta razón, el método recomendado para establecer nombres de objeto es mediante GetNewName.
Sin embargo, si establece la propiedad Name directamente, no se realizan las mismas comprobaciones de validación, pudiendo dar lugar a errores de validación XML. El hecho de que se produzca un error realmente depende del carácter de control que aparece en el nombre.
Aunque los caracteres de control nunca se deben usar en un nombre de objeto, Analysis Services no los impide expresamente. Las versiones anteriores de Analysis Services aceptaban algunas veces caracteres de control en un nombre de objeto. Por esta razón, SQL Server 2012 Analysis Services (SSAS) omitirá los caracteres de control en un nombre de objeto para evitar que las soluciones anteriores dejen de funcionar.
No se pueden utilizar los valores reservados siguientes:
AUX
CLOCK$
De COM1 a COM9 (COM1, COM2, COM3, etc.)
CON
De LPT1 a LPT9 (LPT1, LPT2, LPT3, etc.)
NUL
PRN
En la tabla siguiente se enumeran los caracteres adicionales que no se pueden utilizar dentro del valor de un elemento Name, en función del elemento primario.
Elemento primario |
Caracteres no válidos |
|---|---|
El nombre debe seguir las reglas de los nombres de equipo de Microsoft Windows. Las direcciones IP no son válidas. |
|
:/\*|?"()[]{}<> |
|
.,;'`:/\*|?"&%$!+=[]{}<> |
|
Todos los demás elementos primarios |
.,;'`:/\*|?"&%$!+=()[]{}<> |