StrToSet (MDX)

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

Syntax

  
StrToSet(Set_Specification [,CONSTRAINED] )   

Arguments

Set_Specification
Doğrudan veya dolaylı olarak bir kümeyi belirten geçerli bir dize ifadesi.

Remarks

StrToSet fonksiyonu, dizide belirtilen kümeyi döndürür. StrToSet fonksiyonu genellikle kullanıcı tanımlı fonksiyonlarla harici bir fonksiyondan bir set spesifikasyonunu MDX ifadesine geri döndürmek veya bir MDX sorgusu parametre edildiğinde kullanılır.

  • CONSTRAINED bayrağı kullanıldığında, set spesifikasyonu nitelikli veya niteliksiz üye isimleri veya desteklerle {}çevrili nitelikli veya niteliksiz üye isimleri içeren bir tuple seti 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, aşağıdaki hata ortaya çıkar: "STRTOSET fonksiyonunda CONSTRAINED bayrağı tarafından uygulanan kısıtlamalar ihlal edildi."

  • CONSTRAINED bayrağı kullanılmadığında, belirtilen küme belirtimi geçerli bir Çok Boyutlu İfadeler (MDX) ifadesine çözümlenebilir ve bu ifade bir küme döndürebilir.

  • Kümeler ve üyeler arasındaki farkları daha iyi anlamak için bkz. Küme İfadeleri Kullanımı ve Üye İfadeleri Kullanımı.

Examples

Aşağıdaki örnek, StrToSet fonksiyonunu kullanarak State-Province öznitelik hiyerarşisinin üyelerinin kümesini döndürür. Küme spesifikasyonu, geçerli bir MDX küme ifadesi sağlar.

SELECT StrToSet ('[Geography].[State-Province].Members')  
ON 0  
FROM [Adventure Works]  
  

Aşağıdaki örnek, CONSTRAINED bayrağı nedeniyle bir hata döndürür. Küme spesifikasyonu geçerli bir MDX küme ifadesi sağlarken, CONSTRAINED bayrağı küme spesifikasyonunda nitelikli veya niteliksiz üye isimleri gerektirir.

SELECT StrToSet ('[Geography].[State-Province].Members', CONSTRAINED)  
ON 0  
FROM [Adventure Works]  
  

Aşağıdaki örnek, Almanya ve Kanada için Satıcı Satış Miktarı ölçüsünü geri döndürür. Belirtilen dizide sağlanan küme spesifikasyonu, CONSTRAINED bayrağının gerektirdiği şekilde nitelikli üye adlarını içerir.

SELECT StrToSet ('{[Geography].[Geography].[Country].[Germany],[Geography].[Geography].[Country].[Canada]}', CONSTRAINED)  
ON 0  
FROM [Adventure Works]