Använda variabler och parametrar (MDX)

Gäller för: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

I Microsoft SQL Server Analysis Services kan du parametrisera en MDX-instruktion (Multidimensional Expressions). Med en parameteriserad instruktion kan du skapa allmänna instruktioner som kan anpassas vid körning.

När du skapar en parameteriserad instruktion identifierar du parameternamnet genom att prefixa namnet med at-tecknet (@). Det skulle till exempel @Year vara ett giltigt parameternamn

MDX stöder endast parametrar för literala eller skalära värden. Om du vill skapa en parameter som refererar till en medlem, uppsättning eller tupler måste du använda en funktion som StrToMember eller StrToSet.

I följande XML for Analysis-exempel (XMLA) innehåller parametern @CountryName det land/den region där kunddata hämtas:

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

Om du vill använda den här funktionen med OLE DB använder du gränssnittet ICommandWithParameters . Om du vill använda den här funktionen med ADOMD.Net använder du samlingen AdomdCommand.Parameters .

Se även

Grunderna för MDX-skript (Analysis Services)