Regras de nomenclatura de objetos (Analysis Services)

Aplica-se a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Este tópico descreve as convenções de nomeação de objetos, bem como as palavras e caracteres reservados que não podem ser usados em qualquer nome de objeto, em código ou script no SQL Server Analysis Services.

Convenções de nomenclatura

Cada objeto tem uma propriedade Nome e ID que deve ser única dentro do âmbito da coleção pai. Por exemplo, duas dimensões podem ter o mesmo nome desde que cada uma resida numa base de dados diferente.

Embora possas especificá-lo manualmente, o ID é normalmente gerado automaticamente quando o objeto é criado. Nunca deve mudar o ID depois de começar a construir um modelo. Todas as referências de objetos ao longo de um modelo baseiam-se no ID. Assim, alterar um ID pode facilmente resultar na corrupção do modelo.

Os objetos DataSource e DataSourceView têm exceções notáveis às convenções de nomenclatura. DataSource O ID pode ser definido como um único ponto (.), que não é único, como referência à base de dados atual. Uma segunda exceção é o DataSourceView, que adere às convenções de nomenclatura definidas para objetos DataSet no .NET Framework, onde o Nome é usado como identificador.

As seguintes regras aplicam-se às propriedades de Nome e ID .

  • Os nomes são insensíveis a maiúsculas e minúsculas. Não pode ter um cubo chamado "sales" e outro chamado "Sales" na mesma base de dados.

  • Não são permitidos espaços iniciais ou finais num nome de objeto, embora possas incorporar espaços dentro de um nome. Os espaços dianteiros e traseiros são implicitamente aparados. Isto aplica-se tanto ao Nome como ao ID de um objeto.

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

  • Não existe um requisito especial para o primeiro carácter de um identificador. O primeiro carácter pode ser qualquer personagem válido.

Palavras e Caracteres Reservados

As palavras reservadas estão em inglês e aplicam-se aos nomes dos objetos, não às legendas. Se usar inadvertidamente uma palavra reservada no nome de um 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 qualquer nome de objeto, em momento algum.

Para modelos tabulares, onde a compatibilidade da base de dados é definida para 1103, as regras de validação foram flexibilizadas para certos objetos, devido à conformidade com os requisitos de caracteres estendidos e as convenções de nomes de certas aplicações clientes. As bases de dados que cumprem estes critérios estão sujeitas a regras de validação menos rigorosas. Neste caso, é possível que o nome de um objeto inclua um carácter restrito e ainda assim passe validação.

Palavras Reservadas

  • AUX

  • RELÓGIO$

  • COM1 até COM9 (COM1, COM2, COM3, e assim sucessivamente)

  • Contra

  • LPT1 a LPT9 (LPT1, LPT2, LPT3, e assim sucessivamente)

  • NUL

  • PRN

  • NULL não é permitido como carácter em qualquer string dentro do XML

Personagens Reservados

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

Objeto Caracteres inválidos
Server Siga as convenções de nomenclatura de servidores Windows ao nomear um objeto servidor. Ver Convenções de Nomenclatura (Windows) para mais detalhes.
Fonte de dados : / \ * | ? " () [] {}<>
Nível ou Atributo . , ; ' ` : / \ * | ? "& % $! + = [] {}<>
Dimensão ou Hierarquia . , ; ' ` : / \ * | ? "& % $! + = () [] {}<,>
Todos os outros objetos . , ; ' ` : / \ * | ? "& % $! + = () [] {}<>

Exceções: Quando Personagens Reservadas São Permitidas

Como referido, bases de dados de uma modalidade específica e nível de compatibilidade podem ter nomes de objetos que incluem caracteres reservados. Atributos de dimensão, hierarquia, nível, medida e nomes de objetos KPI podem incluir caracteres reservados, para bases de dados tabulares (1103 ou superiores) que permitem o uso de caracteres estendidos:

Modo servidor e nível de compatibilidade com bases de dados Personagens reservados são permitidos?
MOLAP (todas as versões) Não
Tabular - 1050 Não
Tabular - 1100 Não
Tabular - 1130 e acima Yes

As bases de dados podem ter um ModelType como predefinido. , A predefinição é equivalente a multidimensional e, portanto, não suporta o uso de caracteres reservados nos nomes das colunas.

Ver também

MDX Palavras Reservadas
Suporte de tradução em Serviços de Análise