Compartilhar via


Parâmetros para consultas DAX

Este tópico ilustra como passar valores de parâmetros de uma estrutura XMLA para uma instrução de consulta DAX.

Parâmetros em consultas XMLA e DAX

Uma instrução de consulta DAX bem definida teria um enorme ganho se pudesse ser parametrizada e usada, repetidas vezes, com apenas alterações nos valores de parâmetros.

O método Método Execute (XMLA), em XMLA, tem um elemento de coleção Elemento Parameters (XMLA) que permite definir parâmetros e atribuir um valor a eles; na coleção, cada elemento Elemento Parameter (XMLA) define o nome do parâmetro e um valor para ele.

A sintaxe da consulta DAX permite referenciar parâmetros XMLA, prefixando o nome do parâmetro com um caractere @. Consequentemente, em qualquer local na sintaxe que permita um valor, ele poderá ser substituído por uma chamada de parâmetro. Entretanto, lembre-se de que todos os parâmetros XMLA são digitados como texto.

Observação sobre cuidadosCuidado

Os parâmetros definidos na seção de parâmetros e não utilizados no elemento <STATEMENT> geram uma resposta de erro em XMLA.

Observação sobre cuidadosCuidado

Os parâmetros usados e não definidos no elemento <Parameters> geram uma resposta de erro em XMLA.