StrToSet (MDX)

回傳由多維表達(MDX)格式字串所指定的集合。

Syntax

  
StrToSet(Set_Specification [,CONSTRAINED] )   

論點

Set_Specification
一個有效字串表達式,直接或間接指定一個集合。

備註

StrToSet 函式回傳字串表達式中指定的集合。 StrToSet 函式通常與使用者自訂函式一起使用,用以將外部函式的集合規格回傳至 MDX 陳述式,或在 MDX 查詢參數化時使用。

  • 當使用 CONSTRAINED 旗標時,集合規範必須包含合格或不限定的成員名稱,或一組包含合格或未限定成員名稱的元組,並以大括 {}號包圍。 此旗標用來降低透過指定字串引發注入攻擊的風險。 若提供一個字串無法直接解析至合格或不限定成員名稱,則會出現以下錯誤:「STRTOSET 函式中 CONSTRAINED 標誌所施加的限制已被違反。」

  • 當未使用限制標誌時,指定的集合規範可解析為有效的多維表達式(MDX)表達式,回傳集合。

  • 欲更了解集合與成員的差異,請參閱《使用集合表達式》和《使用成員表達式》。

Examples

以下範例使用 StrToSet 函式回傳 State-Province 屬性階層的成員集合。 集合規範提供有效的 MDX 集合表達式。

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

以下範例因 CONSTRAINED 標誌而回傳錯誤。 雖然集合規範提供有效的 MDX 集合表達式,但 CONSTRAINED 旗標要求集合規範中包含合格或非限定的成員名稱。

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

以下範例回傳德國與加拿大的經銷商銷售金額指標。 指定字串中提供的集合規範包含符合 CONSTRAINED 標誌要求的合格成員名稱。

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