sp_register_custom_scripting (Transact-SQL)

Aplica-se a:SQL Server

A replicação permite procedimentos armazenados personalizados definidos pelo usuário, para substituir um ou mais dos procedimentos padrão usados em replicação transacional. Quando uma alteração de esquema é feita em uma tabela replicada, esses procedimentos armazenados são recriados. sp_register_custom_scripting registra um procedimento armazenado ou um arquivo de script Transact-SQL que é executado quando ocorre uma alteração de esquema para criar um script da definição de um novo procedimento armazenado personalizado definido pelo usuário. Esse novo procedimento armazenado personalizado deve refletir o novo esquema da tabela. sp_register_custom_scripting é executado no Publicador no banco de dados de publicação e o arquivo de script registrado ou procedimento armazenado é executado no Assinante quando ocorre uma alteração de esquema.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_register_custom_scripting [ @type  = ] 'type'  
    [ @value = ] 'value'   
    [ , [ @publication = ] 'publication' ]  
    [ , [ @article = ] 'article' ]  

Argumentos

[ @type = ] 'type' É o tipo de procedimento armazenado personalizado ou script que está sendo registrado. type é varchar(16), sem padrão, e pode ser um dos seguintes valores.

Valor	Descrição
insert	Procedimento armazenado personalizado registrado é executado quando uma instrução INSERT é replicada.
update	Procedimento armazenado personalizado registrado é executado quando uma instrução UPDATE é replicada.
excluir	Procedimento armazenado personalizado registrado é executado quando uma instrução DELETE é replicada.
custom_script	O script é executado ao término do gatilho DDL (Data Definition Language).

[ @value = ] 'value' Nome de um procedimento armazenado ou nome e caminho totalmente qualificado para o arquivo de script Transact-SQL que está sendo registrado. value é nvarchar(1024), sem padrão.

Observação

Especificar NULL para o parâmetro value cancelará o registro de um script registrado anteriormente, que é omesmo que executar sp_unregister_custom_scripting.

Quando o valor do tipo é custom_script, o nome e o caminho completo de um arquivo de script Transact-SQL são esperados. Caso contrário, o valor deve ser o nome de um procedimento armazenado registrado.

[ @publication = ] 'publication' Nome da publicação para a qual o procedimento armazenado personalizado ou script está sendo registrado. publication é sysname, com um padrão de NULL.

[ @article = ] 'article' Nome do artigo para o qual o procedimento armazenado personalizado ou script está sendo registrado. article é sysname, com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (fracasso)

Comentários

sp_register_custom_scripting é usado em snapshot e replicação transacional.

Esse procedimento armazenado deve ser executado antes de efetuar uma alteração de esquema em uma tabela replicada. Para obter mais informações sobre como usar esse procedimento armazenado, consulte Regenerar procedimentos transacionais personalizados para refletir alterações de esquema.

Permissões

Somente membros da função de servidor fixa sysadmin, da função de banco de dados fixa db_owner ou da função de banco de dados fixa db_ddladmin podem executar sp_register_custom_scripting.

Confira também

sp_unregister_custom_scripting (Transact-SQL)