StrToTuple (MDX)

Zwraca krotkę określoną przez ciąg sformatowany w Multidimensional Expressions (MDX).

Syntax

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

Arguments

Tuple_Specification
Poprawne wyrażenie w ciągu tekstu określające, bezpośrednio lub pośrednio, krotkę.

Remarks

Funkcja StrToTuple zwraca określony zbiór. Funkcja StrToTuple jest zazwyczaj używana z funkcjami zdefiniowanymi przez użytkownika do zwracania specyfikacji krotki z funkcji zewnętrznej z powrotem do instrukcji MDX.

  • Gdy używana jest flaga CONSTRAINED, specyfikacja krotki musi zawierać kwalifikowane lub niekwalifikowane nazwy członków. Ta flaga służy do zmniejszenia ryzyka ataków wstrzykujących za pomocą określonego ciągu łańcuchów. Jeśli podano ciąg znaków, który nie da się bezpośrednio rozwiązywać do kwalifikowanych lub niekwalifikowanych nazw członków, pojawia się następujący błąd: "Ograniczenia narzucone przez flagę CONSTRAINED w funkcji STRTOTUPLE zostały naruszone."

  • Gdy flaga CONSTRAINED nie jest używana, określony krotk może rozwiązywać się do poprawnego wyrażenia MDX, które zwraca krotkę.

Examples

Poniższy przykład zwraca miarę Kwoty Sprzedaży Resellera dla członka Bayern za rok kalendarzowy 2004. Specyfikacja krotk, która jest podana, zawiera poprawne wyrażenie krotek MDX.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])')  
ON 0  
FROM [Adventure Works]  
  

Poniższy przykład zwraca miarę Kwoty Sprzedaży Resellera dla członka Bayern za rok kalendarzowy 2004. Specyfikacja krotki, która jest dostarczana, zawiera kwalifikowane nazwy członków, zgodnie z wymaganiami flagi CONSTRAINED.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])', CONSTRAINED)  
ON 0  
FROM [Adventure Works]  
  

Poniższy przykład zwraca miarę Kwoty Sprzedaży Resellera dla członka Bayern za rok kalendarzowy 2004. Specyfikacja krotk, która jest podana, zawiera poprawne wyrażenie krotek MDX.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])')  
ON 0  
FROM [Adventure Works]  
  

Poniższy przykład zwraca błąd spowodowany flagą CONSTRAINED. Chociaż specyfikacja krotk zawiera poprawne wyrażenie krotek MDX, flaga CONSTRAINED wymaga kwalifikowanych lub niekwalifikowanych nazw członków w specyfikacji krotki.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)  
ON 0  
FROM [Adventure Works]