Compartilhar via

SetToArray (MDX)

  • Artigo

Converte um ou mais conjuntos para uma matriz para uso em uma função definida pelo usuário.

Sintaxe

  
SetToArray(Set_Expression1 [ ,Set_Expression2,...n ][ ,Numeric_Expression ] )

Argumentos

Set_Expression1
Uma expressão MDX válida que retorna um conjunto.

Set_Expression2
Uma expressão MDX válida que retorna um conjunto.

Numeric_expression
Uma expressão numérica válida, geralmente uma linguagem MDX de coordenadas de célula, que retorna um número.

Comentários

A função SetToArray converte um ou mais conjuntos em uma matriz para uso em uma função definida pelo usuário. O número de dimensões na matriz resultante é igual ao número de conjuntos especificados.

A expressão numérica opcional pode fornecer os valores nas células da matriz. Se uma expressão numérica não for especificada, a junção cruzada dos conjuntos será avaliada no contexto atual.

As coordenadas da célula na matriz resultante correspondem à posição dos conjuntos na lista. Por exemplo, há três conjuntos: SA, SB e SC. Cada um desses conjuntos tem dois elementos. A instrução MDX, SetToArray(SA, SB, SC), cria a matriz tridimensional a seguir:

(SA1, SB1, SC1) (SA2, SB1, SC1) (SA1, SB2, SC1) (SA2, SB2, SC1)   
(SA1, SB1, SC2) (SA2, SB1, SC2) (SA1, SB2, SC2) (SA2, SB2, SC2)

Observação

O tipo de retorno da função SetToArray é o tipo VARIANT, VT_ARRAY. Portanto, a saída da função SetToArray deve ser usada apenas como entrada para uma função definida pelo usuário.

Exemplo

O exemplo a seguir retorna uma matriz.

SetToArray([Geography].[Geography].Members, [Measures].[Internet Sales Amount])

Consulte Também

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