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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de