Share via

StrToMember (MDX)

  • Artikel

Mengembalikan anggota yang ditentukan oleh string berformat Ekspresi Multidmensional (MDX).

Sintaks

  
StrToMember(Member_Name [,CONSTRAINED] )

Argumen

Member_Name
Ekspresi string yang valid yang menentukan, secara langsung atau tidak langsung, anggota.

Keterangan

Fungsi StrToMember mengembalikan anggota yang ditentukan dalam ekspresi string. Fungsi StrToMember biasanya digunakan dengan fungsi yang ditentukan pengguna untuk mengembalikan spesifikasi anggota dari fungsi eksternal kembali ke pernyataan MDX, atau ketika kueri MDX diparameterkan.

  • Ketika bendera DIBATASI digunakan, nama anggota harus langsung dapat diselesaikan ke 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 STRTOMEMBER dilanggar."

  • Ketika bendera DIBATASI tidak digunakan, anggota yang ditentukan dapat menyelesaikan secara langsung ke nama anggota atau dapat mengatasi ekspresi MDX yang diselesaikan ke nama.

  • Untuk lebih memahami perbedaan antara set dan anggota, lihat Menggunakan Atur Ekspresi dan Menggunakan Ekspresi Anggota.

Contoh

Contoh berikut mengembalikan ukuran Jumlah Penjualan Penjual untuk anggota Bayern dalam hierarki atribut State-Province menggunakan fungsi StrToMember . String yang ditentukan memberikan nama anggota yang memenuhi syarat.

SELECT {StrToMember ('[Geography].[State-Province].[Bayern]')}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]

Contoh berikut mengembalikan ukuran Jumlah Penjualan Penjual untuk anggota Bayern menggunakan fungsi StrToMember . Karena string nama anggota hanya menyediakan nama anggota yang tidak memenuhi syarat, kueri mengembalikan instans pertama anggota yang ditentukan, yang kebetulan berada dalam hierarki Geografi Pelanggan di dimensi Pelanggan, yang tidak bersinggungan dengan Penjualan Penjual. Praktik terbaik menentukan nama yang memenuhi syarat untuk memastikan hasil yang diharapkan.

SELECT {StrToMember ('[Bayern]').Parent}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]

Contoh berikut mengembalikan ukuran Jumlah Penjualan Penjual untuk anggota Bayern dalam hierarki atribut State-Province menggunakan fungsi StrToMember . String nama anggota yang disediakan diselesaikan ke nama anggota yang memenuhi syarat.

SELECT {StrToMember('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)}  
ON 0,  
{[Measures].[Reseller Sales Amount]} ON 1  
FROM [Adventure Works]

Contoh berikut mengembalikan kesalahan karena bendera CONSTRAINED. Meskipun string nama anggota yang disediakan berisi ekspresi anggota MDX valid yang diselesaikan ke nama anggota yang memenuhi syarat, bendera CONSTRAINED memerlukan nama anggota yang memenuhi syarat atau tidak memenuhi syarat dalam string nama anggota.

SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)  
ON 0  
FROM [Adventure Works]

Lihat Juga

Referensi Fungsi MDX (MDX)