sp_register_custom_scripting (Transact-SQL)

Se aplica a:SQL Server

La replicación permite que los procedimientos almacenados personalizados definidos por el usuario sustituyan a uno o más de los procedimientos predeterminados utilizados en la replicación transaccional. Cuando se realiza un cambio en el esquema en una tabla replicada, estos procedimientos almacenados se vuelven a crear. sp_register_custom_scripting registra un procedimiento almacenado o un archivo de script transact-SQL que se ejecuta cuando se produce un cambio de esquema para generar scripts de la definición de un nuevo procedimiento almacenado personalizado definido por el usuario. Este nuevo procedimiento almacenado personalizado definido por el usuario debe reflejar el nuevo esquema de la tabla. sp_register_custom_scripting se ejecuta en el publicador de la base de datos de publicación y el archivo de script registrado o el procedimiento almacenado se ejecuta en el suscriptor cuando se produce un cambio de esquema.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @type = ] 'type' Es el tipo de procedimiento almacenado personalizado o script que se está registrando. type es varchar(16), sin valor predeterminado y puede ser uno de los siguientes valores.

Value	Descripción
insert	El procedimiento almacenado personalizado registrado se ejecuta cuando se replica una instrucción INSERT.
update	El procedimiento almacenado personalizado registrado se ejecuta cuando se replica una instrucción UPDATE.
eliminación	El procedimiento almacenado personalizado registrado se ejecuta cuando se replica una instrucción DELETE.
custom_script	El script se ejecuta al final del desencadenador de lenguaje de definición de datos (DDL).

[ @value = ] 'value' Nombre de un procedimiento almacenado o nombre y ruta de acceso completa al archivo de script transact-SQL que se está registrando. value es nvarchar(1024), sin valor predeterminado.

Nota:

Al especificar NULL para el parámetro value, se anulará el registro de un script registrado anteriormente, que es el mismo que ejecutar sp_unregister_custom_scripting.

Cuando el valor de tipo es custom_script, se espera el nombre y la ruta de acceso completa de un archivo de script de Transact-SQL. De lo contrario, el valor debe ser el nombre de un procedimiento almacenado registrado.

[ @publication = ] 'publication' Nombre de la publicación para la que se está registrando el procedimiento almacenado personalizado o el script. publication es sysname, con un valor predeterminado de NULL.

[ @article = ] 'article' Nombre del artículo para el que se registra el procedimiento almacenado personalizado o el script. article es sysname, con un valor predeterminado de NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_register_custom_scripting se usa en la replicación transaccional y de instantáneas.

Se debe ejecutar este procedimiento almacenado antes de realizar un cambio en el esquema en una tabla replicada. Para obtener más información sobre el uso de este procedimiento almacenado, consulte Regeneración de procedimientos transaccionales personalizados para Reflexiones cambios de esquema.

Permisos

Solo los miembros del rol fijo de servidor sysadmin , el rol fijo de base de datos db_owner o el rol fijo de base de datos db_ddladmin pueden ejecutar sp_register_custom_scripting.

Consulte también

sp_unregister_custom_scripting (Transact-SQL)