Compartilhar via


Usando variáveis e parâmetros (MDX)

No Microsoft SQL Server Analysis Services, é possível parametrizar uma instrução MDX. Uma instrução parametrizada permite a criação de instruções genéricas que podem ser personalizadas no tempo de execução.

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 do XML for Analysis (XMLA) a seguir, o parâmetro @CountryName conterá o país para o qual os dados dos clientes serão recuperados:

<Envelope xmlns="https://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 coleção AdomdCommand.Parameters .

Consulte também

Conceitos