Criando procedimentos armazenados

Artigo
12/23/2023

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

Todos os procedimentos armazenados devem ser associados a uma classe CLR (Common Language Runtime) ou COM (Component Object Model) para poderem seu usados. A classe deve ser instalada no servidor - geralmente na forma de uma DLL (biblioteca de vínculo dinâmico) do Microsoft ActiveX® - e registrada como um assembly no servidor ou em um banco de dados SQL Server Analysis Services.

Procedimentos armazenados são registrados em um servidor ou em um banco de dados. Procedimentos armazenados do servidor podem ser chamados a partir de qualquer contexto de consulta. Procedimentos armazenados do banco de dados podem ser acessados somente se o contexto do banco de dados for o banco de dados no qual o procedimento armazenado foi definido. Se as funções de um assembly chamarem funções de um assembly diferente, registre ambos no mesmo contexto (servidor ou banco de dados). Para um servidor ou um banco de dados microsoft SQL Server SQL Server Analysis Services implantado em um servidor, você pode usar SQL Server Management Studio para registrar um assembly. Para um projeto de SQL Server Analysis Services, você pode usar SQL Server Analysis Services Designer para registrar um assembly no projeto.

Importante

Os assemblies COM podem representar um risco à segurança. Devido a esse risco e outras considerações, os assemblies COM foram preteridos no SSAS (SQL Server 2008 Analysis Services). Talvez não haja suporte para assemblies COM em versões futuras.

Registrando um assembly de servidor

Em Pesquisador de Objetos no SQL Server Management Studio, os assemblies de servidor são listados na pasta Assemblies em uma instância de SQL Server Analysis Services. Os assemblies de servidor podem conter assemblies .NET (CLR) e bibliotecas COM.

Para criar um assembly de servidor

Expanda a instância do SQL Server Analysis Services em Pesquisador de Objetos, clique com o botão direito do mouse na pasta Assemblies e clique em Novo Assembly. Isso exibe a caixa de diálogo Registrar Assembly do Servidor .
Para Tipo , especifique o tipo de assembly:
- Como DLL de código gerenciado (CLR), especifique .NET Assembly.
- Para uma DLL com código nativo (COM), especifique DLL COM.
Para Nome do arquivo, especifique a DLL que contém os procedimentos armazenados.
Para Nome do assembly, especifique um nome para o assembly.
Se esse for um build de depuração da biblioteca que você usará para depurar procedimentos armazenados, selecione a caixa Incluir informações de depuração marcar. Para obter mais informações sobre a depuração de procedimentos armazenados, consulte Depurando procedimentos armazenados.
Você pode clicar em OK para registrar o assembly imediatamente ou, na barra de ferramentas da caixa de diálogo, você pode clicar em um comando no menu Script para criar script da ação de registro para uma janela de consulta, um arquivo ou a Área de Transferência.

Depois de registrar um assembly de servidor, você pode configurá-lo clicando com o botão direito do mouse no assembly em Pesquisador de Objetos e clicando em Propriedades.

Registrando um assembly de banco de dados no servidor

Em Pesquisador de Objetos no SQL Server Management Studio, os assemblies de banco de dados são listados na pasta Assemblies em um banco de dados SQL Server Analysis Services. Os assemblies de banco de dados podem conter assemblies .NET (CLR) e bibliotecas COM.

Para criar um assembly de banco de dados em um servidor

Expanda a instância do banco de dados SQL Server Analysis Services em Pesquisador de Objetos, clique com o botão direito do mouse na pasta Assemblies e clique em Novo Assembly. Isso exibe a caixa de diálogo Registrar Assembly de Banco de Dados .
Para Tipo , especifique o tipo de assembly:
- Como DLL de código gerenciado (CLR), especifique .NET Assembly.
- Como DLL de código nativo (COM), especifique COM DLL.
Para Nome do arquivo, especifique a DLL que contém os procedimentos armazenados.
Para Nome do assembly, especifique um nome para o assembly.
Se esse for um build de depuração da biblioteca que você usará para depurar procedimentos armazenados, selecione a caixa Incluir informações de depuração marcar. Para obter mais informações sobre a depuração de procedimentos armazenados, consulte Depurando procedimentos armazenados.
Você pode clicar em OK para registrar o assembly imediatamente ou, na barra de ferramentas da caixa de diálogo, você pode clicar em um comando no menu Script para criar script da ação de registro para uma janela de consulta, um arquivo ou a Área de Transferência.

Depois de registrar um assembly de banco de dados, você pode configurá-lo clicando com o botão direito do mouse no assembly em Pesquisador de Objetos e clicando em Propriedades.

Registrando um assembly de banco de dados em um projeto

Em Gerenciador de Soluções em SQL Server Data Tools, os assemblies de banco de dados são listados na pasta Assemblies em um projeto de SQL Server Analysis Services. Os assemblies de banco de dados podem conter assemblies .NET (CLR) e bibliotecas COM.

Para criar um assembly de banco de dados em um projeto do Analysis Service

Expanda a instância do banco de dados SQL Server Analysis Services em Pesquisador de Objetos, clique com o botão direito do mouse na pasta Assemblies e clique em Nova Referência de Assembly. Isso exibe a caixa de diálogo Adicionar Referência . A guia .NET da caixa de diálogo Adicionar Referência lista assemblies .NET (CLR) existentes , enquanto a guia Projetos lista projetos.
Você pode clicar em um componente ou projeto existente e, em seguida, clicar em Adicionar para adicioná-lo ao projeto SQL Server Analysis Services. Para adicionar uma referência a uma DLL COM, clique na guia Procurar para localizar o arquivo. A lista Projetos e componentes selecionados mostra o nome, o tipo, a versão e o local de cada componente que você está adicionando ao projeto.
Quando terminar de selecionar componentes a serem adicionados, clique em OK para adicioná-los ao projeto SQL Server Analysis Services.

Formato de script para um assembly

Registrar um assembly .NET é bastante simples. Um assembly .NET é adicionado a um banco de dados em formato binário que usa o seguinte formato:

<Create>  
   <ObjectDefinition>  
      <Assembly>  
         <Files>  
            <File>  
               <Name>filename</Name>  
               <Type>filetype</Type>  
               <Data>  
                  <Block>binarydatablock</Block>  
                  <Block>binarydatablock</Block>  
                  ...  
               </Data>  
            </File>  
         </Files>  
         <PermissionSet>PermissionSet</PermissionSet>  
      </Assembly>  
   <ObjectDefinition>  
</Create>

Consulte Também

Gerenciamento de assemblies de modelo multidimensional
Definindo procedimentos armazenados

Partilhar via