使用變數與參數 （MDX）

  • 發行項

適用於： SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

在 Microsoft SQL Server SQL Server Analysis Services 中，您可以將多維度表達式 （MDX） 語句參數化。 參數化語句可讓您建立可在運行時間自定義的泛型語句。

在建立參數化語句時，您會在名稱前面加上符號 （@） 來識別參數名稱。 例如，@Year 是有效的參數名稱

MDX 僅支援常值或純量值的參數。 若要建立參考成員、集合或 Tuple 的參數，您必須使用 StrToMember 或 StrToSet等函式。

在下列 XML for Analysis （XMLA） 範例中，@CountryName 參數會包含擷取客戶數據的國家/地區：

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">  
  <Body>  
    <Execute xmlns="urn:schemas-microsoft-com:xml-analysis">  
      <Command>  
        <Statement>  
select [Measures].members on 0,   
       Filter(Customer.[Customer Geography].Country.members,   
              Customer.[Customer Geography].CurrentMember.Name =  
              @CountryName) on 1  
from [Adventure Works]  
</Statement>  
      </Command>  
      <Properties />  
      <Parameters>  
        <Parameter>  
          <Name>CountryName</Name>  
          <Value>'United Kingdom'</Value>  
        </Parameter>  
      </Parameters>  
    </Execute>  
  </Body>  
</Envelope>

若要搭配 OLE DB 使用此功能，您可以使用 ICommandWithParameters 介面。 若要搭配 ADOMD.Net 使用此功能，您可以使用 AdomdCommand.Parameters 集合。

另請參閱

MDX 腳本基本概念 （Analysis Services）