StrToTuple (MDX)

Mengembalikan tuple yang ditentukan oleh string yang diformat Multidimensional Expressions (MDX).

Syntax

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

Arguments

Tuple_Specification
Ekspresi string valid yang menentukan, secara langsung atau tidak langsung, sebuah tuple.

Remarks

Fungsi StrToTuple mengembalikan himpunan yang ditentukan. Fungsi StrToTuple biasanya digunakan dengan fungsi yang didefinisikan pengguna untuk mengembalikan spesifikasi tuple dari fungsi eksternal kembali ke pernyataan MDX.

  • Ketika flag CONSTRAINED digunakan, spesifikasi tuple harus berisi nama anggota yang memenuhi syarat atau tidak memenuhi syarat. Flag ini digunakan untuk mengurangi risiko serangan injeksi melalui string yang ditentukan. Jika string disediakan yang tidak dapat langsung diselesaikan dengan nama anggota yang memenuhi syarat atau tidak, kesalahan berikut muncul: "Pembatasan yang diberlakukan oleh flag CONSTRAINED dalam fungsi STRTOTUPLE telah dilanggar."

  • Ketika flag CONSTRAINED tidak digunakan, tuple yang ditentukan dapat diselesaikan menjadi ekspresi MDX yang valid yang mengembalikan tuple.

Examples

Contoh berikut mengembalikan ukuran Jumlah Penjualan Reseller untuk anggota Bayern untuk tahun kalender 2004. Spesifikasi tuple yang disediakan berisi ekspresi tuple MDX yang valid.

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

Contoh berikut mengembalikan ukuran Jumlah Penjualan Reseller untuk anggota Bayern untuk tahun kalender 2004. Spesifikasi tuple yang disediakan berisi nama anggota yang memenuhi syarat, sesuai dengan persyaratan flag CONSTRAINED.

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

Contoh berikut mengembalikan ukuran Jumlah Penjualan Reseller untuk anggota Bayern untuk tahun kalender 2004. Spesifikasi tuple yang disediakan berisi ekspresi tuple MDX yang valid.

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

Contoh berikut mengembalikan kesalahan akibat flag CONSTRAINED. Sementara spesifikasi tuple yang disediakan mengandung ekspresi tuple MDX yang valid, flag CONSTRAINED memerlukan nama anggota yang memenuhi syarat atau tidak memenuhi syarat dalam spesifikasi tuple.

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