Compartilhar via


Root (MDX)

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

ObservaçãoObservação

Se uma hierarquia de atributo não tiver um membro All, a tupla conterá o membro padrão daquela 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 nenhum nome de dimensão ou expressão de tupla 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) a partir 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 nenhum 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) a partir 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çãoObservação

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

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 All membros de todos os outros atributos de dimensão não incluídos explicitamente na tupla especificada. A tupla especificada deve fazer referência apenas a uma dimensão ou ocorrerá um erro.

Exemplos

O exemplo a seguir retornará a tupla que contém o membro All (ou o padrão se o membro All não existir) a partir 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 Data do cubo Adventure Works e o valor do membro especificado da dimensão Medidas que faz interseção 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 da tupla especificado (1º de julho de 2001, junto com o membro All) (ou o padrão se o membro All não existir) de cada hierarquia não especificada na dimensão Data do cubo Adventure Works e o valor do membro especificado da dimensão Medidas que faz interseção com esses membros padrão.

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

Consulte também

Referência