Root (MDX)

Retorna uma tupla que consiste em Todos os membros de cada hierarquia de atributo dentro do escopo atual em um cubo, dimensão ou tupla. Para obter mais informações sobre Escopo, consulte Instrução SCOPE (MDX).

Observação

Se uma hierarquia de atributos não tiver um membro All , a tupla conterá o membro padrão dessa hierarquia.

Sintaxe

  
Cube syntax  
Root ()  
Dimension syntax  
Root( Dimension_Name )  
Tuple syntax  
Root( Tuple_Expression )  

Argumentos

Dimension_Name
Uma expressão de cadeia de caracteres válida que especifica um nome de dimensão.

Tuple_Expression
Uma linguagem MDX válida que retorna uma tupla.

Comentários

Se nem um nome de dimensão nem uma expressão de tupla forem especificados, a função Raiz retornará uma tupla que contém o membro All (ou o membro padrão se o membro All não existir) de cada hierarquia de atributo no cubo. A ordem dos membros na tupla se baseia na sequência na qual as hierarquias de atributo são definidas no cubo.

Se um nome de dimensão for especificado, a função Root retornará uma tupla que contém o membro All (ou o membro padrão se o membro All não existir) de cada hierarquia de atributo na dimensão especificada com base no contexto do membro atual. A ordem dos membros na tupla se baseia na sequência na qual as hierarquias de atributo são definidas na dimensão.

Observação

Se um nome de hierarquia for especificado, a função Tupla escolherá o nome da dimensão do nome da hierarquia especificado.

Se uma expressão de tupla for especificada, a função Root retornará uma tupla que contém a interseção da tupla especificada e todos os membros de todos os outros atributos de dimensão não incluídos explicitamente na tupla especificada.

Exemplos

O exemplo a seguir retorna a tupla que contém o membro All (ou o padrão se o membro All não existir) de cada hierarquia no cubo Adventure Works.

SELECT Root()ON 0  
FROM [Adventure Works]  

O exemplo a seguir retorna a tupla que contém o membro All (ou o padrão se o membro All não existir) de cada hierarquia na dimensão Date no cubo Adventure Works e o valor para o membro especificado da dimensão Medidas que se cruza com esses membros padrão.

SELECT Root([Date]) ON 0  
FROM [Adventure Works]  
WHERE [Measures].[Order Count]  

O exemplo a seguir retorna a tupla que contém o membro de tupla especificado (1º de julho de 2001, juntamente com o membro All (ou o padrão se o membro All não existir) de cada hierarquia não especificada no cubo Adventure Works da dimensão Data e o valor para o membro especificado da dimensão Measures que se cruza com esses membros.

SELECT Root([Date].[July 1, 2001]) ON 0  
FROM [Adventure Works]  
WHERE [Measures].[Order Count]  

Consulte Também

Referência de função MDX (MDX)