Udostępnij za pośrednictwem


StrToTuple (MDX)

Zwraca spójna kolekcja, określonym przez ciąg –formatted Multidimensional Expressions (MDX).

StrToTuple(Tuple_Specification [,CONSTRAINED] ) 

Argumenty

  • Tuple_Specification
    Wyrażenie tekstowe prawidłowy bezpośrednio lub pośrednio, określając spójna kolekcja.

Remarks

The StrToTuple funkcja returns the specified zestaw. The StrToTuple funkcja is typically used with user-defined functions to return a spójna kolekcja specification from an external funkcja back to an MDX instrukcja.

  • Gdy używana jest flaga ograniczonego, spójna kolekcja specyfikacji musi zawierać nazwy kwalifikowanej lub niekwalifikowanych członka.Ta flaga jest używana do zmniejszenia ryzyka ataków iniekcji za pośrednictwem określonego ciąg znaków.Jeśli ciąg jest pod warunkiem że nie jest element członkowski członkowski bezpośrednio rozpoznawalnej kwalifikowaną lub niekwalifikowanych nazw, zostanie wyświetlony następujący komunikat o błędzie: "Ograniczenia nakładane przez CONSTRAINED flagi w funkcja STRTOTUPLE zostały naruszone. „

  • Gdy flaga ograniczonego nie jest używana, określone spójna kolekcja rozpoznawała prawidłowe wyrażenie MDX zwracające spójna kolekcja.

Przykłady

W poniższym przykładzie zwraca miara Reseller kwota sprzedaży dla element członkowski członkowski Bayern kalendarzowego roku 2004.spójna kolekcja Specyfikacji, która znajduje się zawiera prawidłowe MDX spójna kolekcja wyrażenia.

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

W poniższym przykładzie zwraca miara Reseller kwota sprzedaży dla element członkowski członkowski Bayern kalendarzowego roku 2004.Specyfikacja spójnej kolekcji, która znajduje się zawiera nazwy kwalifikowanych składników, zgodnie z wymaganiami ograniczonego flagi.

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

W poniższym przykładzie zwraca miara Reseller kwota sprzedaży dla element członkowski członkowski Bayern kalendarzowego roku 2004.spójna kolekcja Specyfikacji, która znajduje się zawiera prawidłowe MDX spójna kolekcja wyrażenia.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)')
ON 0
FROM [Adventure Works]

W poniższym przykładzie zwraca błąd z powodu ograniczonego flagi.W czasie, gdy specyfikacja spójna kolekcja, pod warunkiem że zawiera prawidłowe wyrażenie MDX spójnej kolekcji, ograniczonego Flaga wymaga kwalifikowana lub niekwalifikowanych element członkowski nazwy specyfikacji spójna kolekcja.

SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].LastChild)', CONSTRAINED)
ON 0
FROM [Adventure Works]