変数とパラメーターの使用 (MDX)
Microsoft SQL Server Analysis Services では、多次元式 (MDX) ステートメントをパラメーター化できます。 ステートメントをパラメーター化すれば、実行時にカスタマイズ可能な汎用ステートメントを作成できます。
パラメーター化されたステートメントを作成するときには、パラメーター名の前に @ 記号を付けることによってパラメーター名を識別します。 たとえば、@Year は有効なパラメーター名です。
MDX は、リテラルまたはスカラー値用のパラメーターだけをサポートします。 メンバー、セット、または組を参照するパラメーターを作成するには、StrToMember や StrToSet などの関数を使う必要があります。
次の XML for Analysis (XMLA) の例では、@CountryName パラメーターには顧客データの取得対象の国が入ります。
<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>
OLE DB でこの機能を使用するには、ICommandWithParameters インターフェイスを使用します。 ADOMD.Net でこの機能を使用するには、AdomdCommand.Parameters コレクションを使用します。