SetToArray (MDX)SetToArray (MDX)

QUESTO ARGOMENTO SI APPLICA A:sìSQL Server (a partire dalla versione 2008)noDatabase SQL di AzurenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Converte uno o più set in una matrice da utilizzare in una funzione definita dall'utente.Converts one or more sets to an array for use in a user-defined function.

SintassiSyntax


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

ArgomentiArguments

Set_Expression1Set_Expression1
Espressione MDX (Multidimensional Expression) valida che restituisce un set.A valid Multidimensional Expressions (MDX) expression that returns a set.

Set_Expression2Set_Expression2
Espressione MDX (Multidimensional Expression) valida che restituisce un set.A valid Multidimensional Expressions (MDX) expression that returns a set.

Numeric_expressionNumeric_Expression
Espressione numerica valida che in genere è un'espressione MDX (Multidimensional Expression) di coordinate di celle che restituisce un numero.A valid numeric expression that is typically a Multidimensional Expressions (MDX) expression of cell coordinates that return a number.

OsservazioniRemarks

Il SetToArray funzione converte uno o più set in una matrice da utilizzare in una funzione definita dall'utente.The SetToArray function converts one or more sets to an array for use in a user-defined function. Il numero di dimensioni nella matrice risultante corrisponde al numero di set specificati.The number of dimensions in the resulting array is the same as the number of sets specified.

L'espressione numerica facoltativa può specificare i valori per le celle della matrice.The optional numeric expression can provide the values in the array cells. Se non viene specificata un'espressione numerica, il cross join dei set viene valutato nel contesto corrente.If a numeric expression is not specified, the cross join of the sets is evaluated in the current context.

Le coordinate delle celle nella matrice risultante corrispondono alla posizione dei set nell'elenco.The cell coordinates in the resulting array correspond to the position of the sets in the list. Ad esempio, per i tre set SA, SB e SC,For example, there are three sets, SA, SB, and SC. ognuno dei quali contiene due elementi,Each of these sets has two elements. l'istruzione MDX SetToArray(SA, SB, SC) crea la matrice tridimensionale seguente:The MDX statement, SetToArray(SA, SB, SC), creates the following three-dimensional array:

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

Nota

Il tipo restituito del SetToArray funzione è di tipo VARIANT VT_ARRAY.The return type of the SetToArray function is the VARIANT type, VT_ARRAY. Pertanto, l'output del SetToArray funzione deve essere usata solo come input per una funzione definita dall'utente.Therefore, the output of the SetToArray function should be used only as input to a user-defined function.

EsempioExample

Nell'esempio seguente viene restituita una matrice.The following example returns an array.

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

Vedere ancheSee Also

Riferimento alla funzione MDX ( MDX )MDX Function Reference (MDX)