SetToArray (MDX)
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])