Elemento Name (ASSL)
Contém o nome do elemento pai.
Sintaxe
<Action> <!-- or one of the elements listed below in the Element Relationships table -->
...
<Name>...</Name>
...
</Action>
Características do elemento
Característica |
Descrição |
|---|---|
Comprimento e tipo de dados |
Cadeia de caracteres (até 100 caracteres) |
Valor padrão |
Varia |
Cardinalidade |
1-1: elemento obrigatório que ocorre apenas uma única vez |
Relações do elemento
Relação |
Elemento |
|---|---|
Elementos pai |
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 filho |
Nenhum |
Comentários
Cada elemento usado para definir um objeto (uma instância de Microsoft SQL Server Analysis Services, uma hierarquia, um atributo, etc.) tem um elemento Name como uma propriedade. O valor de um elemento Name tem as seguintes restrições:
O valor não pode conter espaços à esquerda ou direita. Se os espaços à esquerda ou direita forem incluídos no valor de um elemento Name, eles serão implicitamente removidos pelo Analysis Services.
O valor não deve conter caracteres de controle. A presença de caracteres de controle em um nome não é recomendada, podendo, algumas vezes, resultar em erros de validação do XML.
Para objetos criados através do método de GetNewName em SQL Server 2012, o AMO procura e descarta subsequentemente todos os caracteres de controle, espaços à esquerda ou espaços à direita no nome. Por isso, o uso de GetNewName é a abordagem recomendada para definir nomes de objeto.
No entanto, se você definir a propriedade Name diretamente, as mesmas verificações de validação não serão executadas, o que possivelmente resultará em erros de validação do XML. A geração de um erro dependerá de qual caractere de controle aparece no nome.
Embora os caracteres de controle nunca devam ser usados em um nome de objeto, o Analysis Services não os evita expressamente. As versões anteriores do Analysis Services às vezes aceitavam caracteres de controle em um nome de objeto. Por isso, o SQL Server 2012 Analysis Services (SSAS) ignorará os caracteres de controle em um nome de objeto para evitar o insucesso de soluções antigas.
Os valores reservados a seguir não podem ser usados:
AUX
CLOCK$
COM1 a COM9 (COM1, COM2, COM3 e assim por diante)
CON
LPT1 a LPT9 (LPT1, LPT2, LPT3 e assim por diante)
NUL
PRN
A tabela a seguir lista os caracteres adicionais que não podem ser usados no valor de um elemento Name, dependendo do elemento pai.
Elemento pai |
Caracteres inválidos |
|---|---|
O nome deve seguir as regras para nomes do computador Windows Microsoft. Os endereços IP não são válidos. |
|
:/\*|?"()[]{}<> |
|
.,;'`:/\*|?"&%$!+=[]{}<> |
|
Todos os outros elementos pai |
.,;'`:/\*|?"&%$!+=()[]{}<> |