Nomeação de objeto (Analysis Services – Dados Multidimensionais)

Nomes de objeto, IDs e referências

Em geral, todo objeto principal contém as seguintes propriedades:

• Name   Normalmente, os nomes de objetos irmãos são exclusivos dentro do escopo da coleção pai. Por exemplo, dois objetos Database diferentes podem ter os mesmos nomes Dimension. Porém, dentro de cada Database, os nomes Dimension são exclusivos. As exceções a esta regra são observadas depois. Por exemplo, nomes de Measure devem ser exclusivos no nível Cube, mas eles não precisam ser exclusivos no nível do pai MeasureGroup.

• ID As restrições de exclusividade que se aplicam a propriedades Name também se aplicam a propriedades ID. Além disso, propriedades ID não podem ser alteradas. Propriedades ID são atribuídas na criação pelo usuário, pelo aplicativo ou automaticamente pelo servidor (se as propriedades não forem especificadas). Se o servidor atribuir propriedades ID, ele definirá as propriedades ID como o nome inicial do objeto.

• Description

Referências de objeto

Os objetos são referenciados por suas propriedades ID. A convenção de nome para as propriedades ID começa no nome com base no tipo de destino, adicionando-se o sufixo "ID" e, possivelmente, um prefixo que fornece informações extras sobre a função que o objeto desempenha. Por exemplo, o objeto é a medida padrão usada em Cube. O tipo de destino do objeto é Measure. Para esse nome de tipo de destino, é adicionado o sufixo "ID" e o prefixo "Padrão". O nome da propriedade ID resultante se torna DefaultMeasureID, como mostrado no código a seguir:

<Cube>

<DefaultMeasureID>Amount</DefaultMeasureID>

…

<Cube>

 

Quando um nome qualificado que consiste em vários IDs é necessário (por exemplo, CubeID e MeasureID ambos referem-se a uma medida em outro Cube), então, um elemento externo é introduzido para conter o conjunto de elementos ID.

Exceções de referência

Uma referência DataSource que consiste em um único ponto (.) refere-se ao banco de dados atual do servidor OLAP atual. Por exemplo, o seguinte fragmento de XML aponta para Database da instância do servidor OLAP atual:

<DataSourceID>.</DataSourceID>

 

Referências aos elementos (DSV) DataSourceView são exceções às regras. Um objeto DataSet em .NET Framework Microsoft descreve o esquema de um DSV. No esquema, um objeto DSV tem um Name, mas não um ID imutável. Portanto, referências a um objeto DSV precisam usar o Name como mecanismo de identificação. Por exemplo, a referência, ColumnBinding.TableID, não contém ID. Em vez disso, a referência contém o Name da tabela apropriada.

Nomeando diretivas

O ASSL aplica as mesmas regras para letras maiúsculas e minúsculas e espaço em branco às propriedades Name e ID usadas no DSO 8.0:

• A verificação de exclusividade quanto a Name e ID não distingue letras maiúsculas de minúsculas. Portanto, não é possível ter um Cube com nome de "vendas" e outro chamado "Vendas" no mesmo banco de dados.

• Como uma propriedade Name ou ID pode conter espaços embutidos, a propriedade não pode conter espaços de abertura ou fechamento. Os espaços de abertura e fechamento são eliminados implicitamente. Essa regra aplica-se tanto para Name quanto para ID de um objeto, bem como aos valores de elementos que fazer referência a esse Name e ID.

As regras a seguir também se aplicam às propriedades Name e ID. Essas regras são semelhantes às regras em DSO 8.0.

• 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 algum caractere válido

Os nomes reservados a seguir não devem 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

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

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

Objeto	Caracteres inválidos
Server	O nome deve seguir as regras para nomes do computador. (Endereços IP não são válidos)
DataSource	: / \ * | ? " () [] {} <>
Level ou Attribute	. , ; ' ` : / \ * | ? " & % $ ! + = [] {} < >
Dimension ou Hierarchy	.,, ; ' ` : / \ * | ? " & % $ ! + = () [] {} <,>
Todos os outros objetos	. , ; ' ` : / \ * | ? " & % $ ! + = () [] {} < >

Nomes localizados

As legendas de objetos visíveis aos clientes (por exemplo, Dimension, hierarquia e Level) podem ser localizados em idiomas diferentes. As legendas para objetos definidos por comandos (por exemplo, medidas calculadas e conjuntos nomeados) são fornecidas como parte da definição MDX de objetos.

As associações de atributos também permitem que uma fonte diferente (por exemplo, uma coluna de fonte diferente) para o nome do atributo seja fornecida para idiomas diferentes.

Não é possível localizar os Nomes dos objetos.