Partilhar via


Utilização de Variáveis e Parâmetros (MDX)

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

No Microsoft SQL Server Analysis Services, pode parametrizar uma instrução em Multidimensional Expressions (MDX). Uma instrução parametrizada permite-lhe criar instruções genéricas que podem ser personalizadas em tempo de execução.

Ao criar uma instrução parametrizada, identifica-se o nome do parâmetro ao prefixar o nome com o sinal at (@). Por exemplo, @Year seria um nome válido de parâmetro

O MDX suporta apenas parâmetros para valores literais ou escalares. Para criar um parâmetro que faça referência a um membro, conjunto ou tuple, teria de usar uma função como StrToMember ou StrToSet.

No exemplo seguinte de XML para Análise (XMLA), 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 esta funcionalidade com OLE DB, utilizaria a interface ICommandWithParameters. Para usar esta funcionalidade com ADOMD.Net, você deveria usar a coleção AdomdCommand.Parameters.

Ver também

Fundamentos de Scripting MDX (Serviços de Análise)