Compartilhar via


Usando variáveis e parâmetros (MDX)

Aplica-se a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

No Microsoft SQL Server SQL Server Analysis Services, você pode parametrizar uma instrução MDX (Multidimensional Expressions). Uma instrução parametrizada permite a criação de instruções genéricas que podem ser personalizadas no runtime.

Ao criar uma instrução parametrizada, você identifica o nome do parâmetro incluindo um prefixo ao nome com o sinal arroba (@). Por exemplo, @Year seria um nome de parâmetro válido

A linguagem MDX oferece suporte apenas a valores literais ou escalares. Para criar um parâmetro que faça referência a um membro, conjunto ou tupla, use uma função como StrToMember ou StrToSet.

No exemplo XMLA (XML for Analysis) a seguir, o @CountryName parâmetro conterá o país/região para o qual os dados do cliente são recuperados:

<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>  

Para usar essa funcionalidade com OLE DB, use a interface ICommandWithParameters . Para usar essa funcionalidade com ADOMD.Net, use a interface AdomdCommand.Parameters .

Consulte Também

Conceitos básicos de geração de scripts MDX (Analysis Services)