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 | Ação, agregação, AggregationDesign, AlgorithmParameter, anotação, assembly, ClrAssemblyFile, cubo, CubeDimension, CubeHierarchy, banco de dados, DataSource, DataSourceView, dimensão, DimensionAttribute, grupo, hierarquia, KPI, nível, MdxScript, medida, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, partição, permissão, perspectiva, PerspectiveCalculation, ReportFormatParameter, ReportParameter, função, servidor, ServerProperty, rastreamento |
Elementos filho | Nenhum |
Comentários
Cada elemento usado para definir um objeto (uma instância de Analysis Services, uma hierarquia, um atributo e assim por diante) 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 espaços à esquerda ou à direita forem incluídos no valor de um elemento de nome , esses espaços serão removidos implicitamente os serviços byAnalysiss.
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 usando o método getnewname no SQL Server, o AMO verifica e subsequentemente remove quaisquer caracteres de controle, espaços à esquerda ou espaços à direita no nome. Por esse motivo, o uso de GetNewName é a abordagem recomendada para a configuração de nomes de objeto.
No entanto, se você definir a propriedade Name diretamente, as mesmas verificações de validação não serão executadas, possivelmente resultando em erros de validação de 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 esse motivo, SQL Server 2016 Analysis Services e posteriores ignorarão os caracteres de controle em um nome de objeto para evitar a quebra de soluções mais 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 dentro do valor de um elemento Name , dependendo do elemento pai.
Elemento pai | Caracteres inválidos |
---|---|
Servidor | o nome deve seguir as regras para Windows nomes de computador. Os endereços IP não são válidos. |
DataSource | :/\\*|?"()[]{}<> ` |
Elemento de nível, atributo | .,;':/\\*|?"&%$!+=[]{}<> ` |
Todos os outros elementos pai | .,;':/\\*|?"&%$!+=()[]{}<> ` |