Compartilhar via


Regras de nomenclatura de objeto (Analysis Services)

Este tópico descreve as convenções de nomenclatura de objeto, bem como as palavras reservadas e os caracteres que não podem ser usados em nenhum nome de objeto, em código ou script no Analysis Services.

Convenções de nomenclatura

Cada objeto tem uma Name propriedade e ID deve ser exclusiva dentro do escopo da coleção pai. Por exemplo, duas dimensões podem ter o mesmo nome, desde que cada uma resida em um banco de dados diferente.

Embora você possa especificá-lo manualmente, normalmente ID é gerado automaticamente quando o objeto é criado. Você nunca deve alterar a ID depois de começar a criar um modelo. Todas as referências de objeto em um modelo são baseadas no ID. Portanto, alterar um ID pode facilmente resultar em corrupção de modelo.

DataSource e DataSourceView objetos têm exceções notáveis para convenções de nomenclatura. DataSource A ID pode ser definida como um único ponto (.), que não é exclusivo, como uma referência ao banco de dados atual. Uma segunda exceção é DataSourceView, que adere às convenções de nomenclatura definidas para DataSet objetos no .NET Framework, em que ela Name é usada como o identificador.

As regras a seguir se aplicam a propriedades e ID propriedadesName.

  • Os nomes não diferenciam maiúsculas de minúsculas. Não é possível ter um cubo chamado "vendas" e outro chamado "Vendas" no mesmo banco de dados.

  • Nenhum espaço à esquerda ou à direita permitido em um nome de objeto, embora você possa inserir espaços dentro de um nome. Os espaços à esquerda e à direita são implicitamente cortados. Isso se aplica ao objeto e ID ao Name objeto.

  • O número máximo de caracteres é 100.

  • Não há nenhum requisito especial para o primeiro caractere de um identificador. O primeiro caractere pode ser qualquer caractere válido.

Palavras e caracteres reservados

As palavras reservadas estão em inglês e se aplicam a nomes de objeto, não a Legendas. Se você usar inadvertidamente uma palavra reservada em um nome de objeto, ocorrerá um erro de validação. Para modelos multidimensionais e de mineração de dados, as palavras reservadas descritas abaixo não podem ser usadas em nenhum nome de objeto, a qualquer momento.

Para modelos de tabela, em que a compatibilidade do banco de dados é definida como 1103, as regras de validação foram relaxadas para determinados objetos, fora de conformidade para os requisitos de caractere estendido e convenções de nomenclatura de determinados aplicativos cliente. Os bancos de dados que atendem a esses critérios estão sujeitos a regras de validação menos rigorosas. Nesse caso, é possível que um nome de objeto inclua um caractere restrito e ainda passe pela validação.

Palavras Reservadas

  • AUX

  • RELÓGIO$

  • COM1 a COM9 (COM1, COM2, COM3 e assim por diante)

  • CON

  • LPT1 a LPT9 (LPT1, LPT2, LPT3 e assim por diante)

  • Nulo

  • PRN

  • NULL não é permitido como um caractere em qualquer cadeia de caracteres dentro do XML

Caracteres reservados

A tabela a seguir lista caracteres inválidos para objetos específicos.

Objeto Caracteres inválidos
Server Siga as convenções de nomenclatura do Windows Server ao nomear um objeto de servidor. Consulte Convenções de Nomenclatura (Windows) para obter detalhes.
DataSource : / \ * \| ? " () [] {} <>
Level ou Attribute . , ; ' ` : / \ * & \| ? " & % $ ! + = [] {} < >
Dimension ou Hierarchy . , ; ' ` : / \ * \| ? " & % $ ! + = () [] {} <,>
Todos os outros objetos . , ; ' ` : / \ * \| ? " & % $ ! + = () [] {} < >

Exceções: quando caracteres reservados são permitidos

Conforme observado, bancos de dados de uma modalidade específica e nível de compatibilidade podem ter nomes de objeto que incluem caracteres reservados. Os nomes de objetos de atributo de dimensão, hierarquia, nível, medida e KPI podem incluir caracteres reservados, para bancos de dados tabulares (1103 ou superior) que permitem o uso de caracteres estendidos:

Nível de compatibilidade de banco de dados e modo de servidor Caracteres reservados permitidos?
MOLAP (todas as versões) Não
Tabular - 1050 Não
Tabular - 1100 Não
Tabular - 1130 e superior Sim

Os bancos de dados podem ter um ModelType de padrão. O padrão é equivalente a multidimensional e, portanto, não dá suporte ao uso de caracteres reservados em nomes de coluna.

Consulte Também

Palavras reservadas do MDX
Traduções (Analysis Services)
XMLA (XML for Analysis Compliance)