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).
.gif "Observação") Observaçã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çã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]