Chamando procedimentos armazenados

Aplica-se a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Procedimentos armazenados podem ser chamados no servidor ou a partir de um aplicativo cliente. Nos dois casos, os procedimentos armazenados são sempre executados no servidor, no contexto do servidor ou de um banco de dados. Não há permissões especiais necessárias para executar um procedimento armazenado. Uma vez adicionado o procedimento armazenado por um assembly ao contexto do servidor ou do banco de dados, qualquer usuário pode executá-lo desde que a função do usuário permita as ações realizadas pelo procedimento armazenado.

O procedimento armazenado em formato MDX é chamado da mesma forma que se chama uma função MDX intrínseca. No caso de um procedimento armazenado sem-parâmetros, o nome do procedimento e um par de parênteses vazios são usados, como mostrado a seguir:

MyStoredProcedure()  

Se o procedimento armazenado tiver um ou mais parâmetros, eles são fornecidos, em ordem, separados por vírgulas. Este é um exemplo de procedimento armazenado com três parâmetros:

MyStoredProcedure("Parameter1", 2, 800)  

Chamando procedimentos armazenados em consultas MDX

Em todas as consultas MDX, o procedimento armazenado deve retornar o tipo sintaticamente correto exigido por uma expressão MDX. Se um procedimento armazenado não retornar o tipo correto, ocorrerá um erro da linguagem MDX. Os exemplos a seguir demonstram procedimentos armazenados que retornam um conjunto, um membro e o resultado de uma operação matemática.

Retornando um conjunto

Os exemplos a seguir implementam um procedimento armazenado, chamado MySproc, que retorna um conjunto. No primeiro exemplo, MySproc retorna o conjunto diretamente na expressão SELECT. Nos dois segundos exemplos, MySproc retorna o conjunto como um argumento para as funções Crossjoin e DrilldownLevel.

SELECT MySetProcedure(a,b,c) ON 0 FROM Sales  
SELECT Crossjoin(MySetProcedure(a,b,c)) ON 0 FROM Sales  
SELECT DrilldownLevel(MySetProcedure(a,b,c)) ON 0 FROM Sales  

Retornando um membro

O exemplo a seguir mostra uma função MySproc que retorna um membro:

SELECT Descendants(MySproc(a,b,c),3) ON 0 FROM Sales  

Retornando o resultado de uma operação matemática

SELECT Country.Members on 0, MySproc(Measures.Sales) ON 1 FROM Sales  

Chamando procedimentos armazenados com a instrução Call

Os procedimentos armazenados podem ser chamados fora do contexto de uma consulta MDX usando a instrução Chamada MDX.

Use esse método para instanciar os efeitos colaterais de uma consulta armazenada ou para o aplicativo obter os resultados de uma consulta armazenada. Um uso comum da instrução Call seria usar AMO (Objetos de Gerenciamento de Análise) para executar funções administrativas que não têm um resultado de retorno. Por exemplo, o comando a seguir chama um procedimento armazenado:

Call MyStoredProcedure(a,b,c)  

O único tipo com suporte retornado do procedimento armazenado em uma instrução Call é um conjunto de linhas. A serialização de um conjunto de linhas é definido pelo XML for Analysis. Se um procedimento armazenado em uma instrução Call retornar qualquer outro tipo, ele será ignorado e não será retornado em XML para o aplicativo de chamada. Para obter mais informações sobre conjuntos de linhas do XML for Analysis, consulte Conjuntos de linhas de esquema do XML for Analysis.

Se um procedimento armazenado retornar um conjunto de linhas do .NET, SQL Server Analysis Services converterá o resultado no servidor em um conjunto de linhas XML for Analysis. O conjunto de linhas XML for Analysis sempre é retornado por um procedimento armazenado na função Call . Se um conjunto de dados contiver recursos que não possam ser expressos no conjunto de linhas do XML for Analysis, ocorrerá uma falha.

Também podem ser empregados procedimentos que retornam valores nulos (por exemplo, sub-rotinas em Visual Basic) com a palavra-chave CALL. Se, por exemplo, você quiser usar a função MyVoidFunction() em uma instrução MDX, a seguinte sintaxe será empregada:

CALL(MyVoidFunction)  

Consulte Também

Gerenciamento de assemblies de modelo multidimensional
Definindo procedimentos armazenados