StrToTuple (MDX)
Mengembalikan tuple yang ditentukan oleh string berformat Ekspresi Multidmensional (MDX).
Sintaks
StrToTuple(Tuple_Specification [,CONSTRAINED] )
Argumen
Tuple_Specification
Ekspresi string yang valid yang menentukan, secara langsung atau tidak langsung, tuple.
Keterangan
Fungsi StrToTuple mengembalikan set yang ditentukan. Fungsi StrToTuple biasanya digunakan dengan fungsi yang ditentukan pengguna untuk mengembalikan spesifikasi tuple dari fungsi eksternal kembali ke pernyataan MDX.
Ketika bendera CONSTRAINED digunakan, spesifikasi tuple harus berisi nama anggota yang memenuhi syarat atau tidak memenuhi syarat. Bendera ini digunakan untuk mengurangi risiko serangan injeksi melalui string yang ditentukan. Jika string disediakan yang tidak dapat diselesaikan secara langsung ke nama anggota yang memenuhi syarat atau tidak memenuhi syarat, kesalahan berikut muncul: "Pembatasan yang diberlakukan oleh bendera CONSTRAINED dalam fungsi STRTOTUPLE dilanggar."
Saat bendera CONSTRAINED tidak digunakan, tuple yang ditentukan dapat diselesaikan ke ekspresi MDX valid yang mengembalikan tuple.
Contoh
Contoh berikut mengembalikan ukuran Jumlah Penjualan Penjual 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 Penjual untuk anggota Bayern untuk tahun kalender 2004. Spesifikasi tuple yang disediakan berisi nama anggota yang memenuhi syarat, seperti yang diperlukan oleh bendera DIBATASI.
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 Penjual 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 karena bendera CONSTRAINED. Meskipun spesifikasi tuple yang disediakan berisi ekspresi tuple MDX yang valid, bendera 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]