sp_addextendedproc (Transact-SQL)sp_addextendedproc (Transact-SQL)

APLICA-SE A: simSQL Server nãoBanco de Dados SQL do Azure nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Registra o nome de um novo procedimento armazenado estendido à MicrosoftMicrosoft SQL ServerSQL Server.Registers the name of a new extended stored procedure to MicrosoftMicrosoft SQL ServerSQL Server.

Observação

Este recurso está em modo de manutenção e talvez seja removido em uma versão futura do Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Em vez disso, use a Integração CLR .Use CLR Integration instead.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

  
sp_addextendedproc [ @functname = ] 'procedure' ,   
     [ @dllname = ] 'dll'  

ArgumentosArguments

[ @functname = ] 'procedure' É o nome da função a ser chamada dentro da biblioteca de vínculo dinâmico (DLL).[ @functname = ] 'procedure' Is the name of the function to call within the dynamic-link library (DLL). procedimento está nvarchar(517) , sem padrão.procedure is nvarchar(517), with no default. procedimento , opcionalmente, pode incluir o nome do proprietário na forma owner.function.procedure optionally can include the owner name in the form owner.function.

[ @dllname = ] 'dll' É o nome da DLL que contém a função.[ @dllname = ] 'dll' Is the name of the DLL that contains the function. dll está varchar(255) , sem padrão.dll is varchar(255), with no default. É recomendável especificar o caminho completo da DLL.It is recommended that you specify the complete path of the DLL.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

NenhumNone

ComentáriosRemarks

Depois que um procedimento armazenado estendido é criado, ele deve ser adicionado ao SQL ServerSQL Server por meio sp_addextendedproc.After an extended stored procedure is created, it must be added to SQL ServerSQL Server by using sp_addextendedproc. Para obter mais informações, consulte adicionando um procedimento armazenado estendido ao SQL Server.For more information, see Adding an Extended Stored Procedure to SQL Server.

Esse procedimento pode ser executado somente na mestre banco de dados.This procedure can be run only in the master database. Para executar um procedimento armazenado estendido de um banco de dados diferente de mestre, qualifique o nome do procedimento armazenado estendido com mestre.To execute an extended stored procedure from a database other than master, qualify the name of the extended stored procedure with master.

sp_addextendedproc adiciona entradas para o sys. Objects exibição de catálogo, registrar o nome do novo procedimento armazenado com SQL ServerSQL Server.sp_addextendedproc adds entries to the sys.objects catalog view, registering the name of the new extended stored procedure with SQL ServerSQL Server. Ele também adiciona uma entrada na extended_procedures exibição do catálogo.It also adds an entry in the sys.extended_procedures catalog view.

Importante

DLLs existentes que não são registradas com um caminho completo não funcionarão depois da atualização do SQL ServerSQL Server.Existing DLLs that were not registered with a complete path will not work after upgrading to SQL ServerSQL Server. Para corrigir o problema, use sp_dropextendedproc para cancelar o registro de DLL e, em seguida, registrá-la novamente com sp_addextendedproc, especificando o caminho completo.To correct the problem, use sp_dropextendedproc to unregister the DLL, and then reregister it with sp_addextendedproc, specifying the complete path.

PermissõesPermissions

Somente os membros dos sysadmin pode executar a função de servidor fixa sp_addextendedproc.Only members of the sysadmin fixed server role can execute sp_addextendedproc.

ExemplosExamples

O exemplo a seguir adiciona o xp_hello o procedimento armazenado estendido.The following example adds the xp_hello extended stored procedure.

USE master;  
GO  
EXEC sp_addextendedproc xp_hello, 'c:\xp_hello.dll';  

Consulte tambémSee Also

EXECUTE (Transact-SQL) EXECUTE (Transact-SQL)
GRANT (Transact-SQL) GRANT (Transact-SQL)
REVOKE (Transact-SQL) REVOKE (Transact-SQL)
sp_dropextendedproc (Transact-SQL) sp_dropextendedproc (Transact-SQL)
sp_helpextendedproc (Transact-SQL) sp_helpextendedproc (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)System Stored Procedures (Transact-SQL)