Compartir a través de

Usar variables y parámetros (MDX)

  • Artículo

Se aplica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

En Microsoft SQL Server SQL Server Analysis Services, puede parametrizar una instrucción de expresiones multidimensionales (MDX). Las instrucciones con parámetros permiten crear instrucciones genéricas que pueden personalizarse en tiempo de ejecución.

Al crear una instrucción con parámetros se debe identificar el nombre del parámetro mediante un prefijo con el símbolo de arroba (@). Por ejemplo, @Year sería un nombre de parámetro válido.

MDX solo admite parámetros para valores literales o escalares. Para crear un parámetro que haga referencia a un miembro, conjunto o tupla debería utilizar una función como StrToMember o StrToSet.

En el siguiente ejemplo de XML for Analysis (XMLA), el @CountryName parámetro contendrá el país o región para el que se recuperan los datos del cliente:

<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 utilizar esta funcionalidad con OLE DB, debería usarse la interfaz ICommandWithParameters . Para utilizar esta funcionalidad con ADOMD.Net, debería usarse la colección AdomdCommand.Parameters .

Consulte también

Aspectos básicos de scripting MDX (Analysis Services)