Partilhar via


Adicionando um procedimento armazenado estendido ao SQL Server

Observação importanteImportante

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e modifique, assim que possível, os aplicativos que atualmente o utilizam. Em vez disso, use a integração CLR.

Uma DLL que contém funções de procedimento armazenado estendido funciona como uma extensão do SQL Server. Para instalar a DLL, copie o arquivo em um diretório, que contenha, por exemplo, os arquivos de DLL padrão do SQL Server (por padrão, C:\Arquivos de Programas\Microsoft SQL Server\MSSQL11.0.x\MSSQL\Binn).

Depois que uma DLL de procedimento armazenado estendido for copiada no servidor, um administrador do sistema do SQL Server deve registrar no SQL Server todas as funções de procedimento armazenado estendido na DLL. Isso é feito por meio do procedimento armazenado do sistema sp_addextendedproc.

Observação sobre segurançaObservação sobre segurança

O administrador do sistema deve examinar inteiramente um procedimento armazenado estendido para garantir que ele não contenha código perigoso ou mal-intencionado, antes de adicioná-lo ao servidor e conceder permissões de execução a outros usuários. Valide todas as entradas de usuário. Não concatene uma entrada de usuário antes de validá-la. Nunca execute um comando construído por uma entrada de usuário inválida.

O primeiro parâmetro de sp_addextendedproc especifica o nome da função e o segundo, o nome da DLL em que essa função reside. É recomendável especificar o caminho completo da DLL.

Observação importanteImportante

As DLLs existentes que não foram registradas com um caminho completo não funcionarão depois da atualização para o SQL Server 2005. Para corrigir o problema, use sp_dropextendedproc para cancelar o registro da DLL e registrá-la novamente com sp_addextendedproc, com a especificação do caminho completo.

O nome da função especificada em sp_addextendedproc deve ser exatamente igual, inclusive maiúsculas e minúsculas, ao nome da função na DLL. Por exemplo, esse comando registra uma função xp_hello,, localizada em uma dll denominada xp_hello.dll, como um procedimento armazenado do SQL Server:

sp_addextendedproc 'xp_hello', 'c:\Program Files\Microsoft SQL Server\MSSQL11.0.MSSQLSERVER\MSSQL\Binn\xp_hello.dll';

Se o nome da função especificado em sp_addextendedproc não corresponder exatamente ao nome da função na DLL, o novo nome será registrado no SQL Server, mas o nome não poderá ser usado. Por exemplo, embora xp_Hello esteja registrado como um procedimento armazenado estendido do SQL Server localizado em xp_hello.dll, o SQL Server não poderá localizar a função na DLL se você usar xp_Hello para chamar a função depois.

--Register the function (xp_hello) with an initial upper case
sp_addextendedproc 'xp_Hello', 'c:\xp_hello.dll';

--Use the newly registered name to call the function
DECLARE @txt varchar(33);
EXEC xp_Hello @txt OUTPUT;

--This is the error message
Server: Msg 17750, Level 16, State 1, Procedure xp_Hello, Line 1
Could not load the DLL xp_hello.dll, or one of the DLLs it references. Reason: 127(The specified procedure could not be found.).

Se o nome da função especificado em sp_addextendedproc corresponder exatamente ao nome da função na DLL, e o agrupamento da instância do SQL Server diferenciar maiúsculas e minúsculas, o usuário poderá chamar o procedimento armazenado estendido usando qualquer combinação de letras maiúsculas e minúsculas no nome.

--Register the function (xp_hello)
sp_addextendedproc 'xp_hello', 'c:\xp_hello.dll';

--The following will succeed in calling xp_hello
DECLARE @txt varchar(33);
EXEC xp_Hello @txt OUTPUT;

DECLARE @txt varchar(33);
EXEC xp_HelLO @txt OUTPUT;

DECLARE @txt varchar(33);
EXEC xp_HELLO @txt OUTPUT;

Quando o agrupamento da instância do SQL Server diferenciar maiúsculas de minúsculas, o SQL Server não poderá chamar o procedimento armazenado estendido – mesmo que tenha sido registrado exatamente com o mesmo nome e agrupamento da função na DLL –, se o procedimento for chamado com um uso de maiúsculas e minúsculas diferente.

--Register the function (xp_hello)
sp_addextendedproc 'xp_hello', 'c:\xp_hello.dll';

--The following will result in an error
DECLARE @txt varchar(33);
EXEC xp_HELLO @txt OUTPUT;

--This is the error
Server: Msg 2812, Level 16, State 62, Line 1

Não é necessário parar e reiniciar o SQL Server.

Consulte também

Referência

sp_addextendedproc (Transact-SQL)

sp_dropextendedproc (Transact-SQL)