StrToTuple (MDX)

Multidimensional Expressions (MDX) formatlı bir diziyle belirtilen tuple'ı döndürür.

Syntax

  
StrToTuple(Tuple_Specification [,CONSTRAINED] )   

Arguments

Tuple_Specification
Doğrudan veya dolaylı olarak bir tuple belirten geçerli bir dize ifadesi.

Remarks

StrToTuple fonksiyonu belirtilen kümeyi döndürür. StrToTuple fonksiyonu genellikle kullanıcı tanımlı fonksiyonlarla birlikte harici bir fonksiyondan bir tuple spesifikasyonunu MDX ifadesine geri döndürmek için kullanılır.

  • CONSTRAINED bayrağı kullanıldığında, tuple spesifikasyonu nitelikli veya niteliksiz üye isimlerini içermelidir. Bu bayrak, belirtilen dizide enjeksiyon saldırı riskini azaltmak için kullanılır. Eğer nitelikli veya niteliksiz üye isimlerine doğrudan çözülemeyen bir dizi sağlanırsa, şu hata ortaya çıkar: "STRTOTUPLE fonksiyonunda CONSTRAINED bayrağı tarafından uygulanan kısıtlamalar ihlal edildi."

  • CONSTRAINED bayrağı kullanılmadığında, belirtilen tuple geçerli bir MDX ifadesine çözümlenebilir ve bu ifade bir tuple döndürebilir.

Examples

Aşağıdaki örnek, Bayern üyesi için 2004 takvim yılı için Satıcı Satış Miktarı ölçüsünü geri getirmektedir. Sağlanan tuple spesifikasyonu, geçerli bir MDX tuple ifadesi içerir.

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

Aşağıdaki örnek, Bayern üyesi için 2004 takvim yılı için Satıcı Satış Miktarı ölçüsünü geri getirmektedir. Sağlanan tuple spesifikasyonu, CONSTRAINED bayrağının gerektirdiği şekilde nitelikli üye isimlerini içerir.

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

Aşağıdaki örnek, Bayern üyesi için 2004 takvim yılı için Satıcı Satış Miktarı ölçüsünü geri getirmektedir. Sağlanan tuple spesifikasyonu, geçerli bir MDX tuple ifadesi içerir.

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

Aşağıdaki örnek, CONSTRAINED bayrağı nedeniyle bir hata döndürür. Sunulan tuple spesifikasyonu geçerli bir MDX tuple ifadesi içerirken, CONSTRAINED bayrağı tuple spesifikasyonunda nitelikli veya niteliksiz üye isimleri gerektirir.

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