sp_register_custom_scripting (Transact-SQL)

La réplica permite que los procedimientos almacenados personalizados definidos por el usuario sustituyan a uno o más de los procedimientos predeterminados utilizados en la réplica 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 secuencias de comandos Transact-SQL que se ejecuta cuando se produce un cambio en el esquema para convertir en secuencia de comandos 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 publicaciones, mientras que el archivo de secuencias de comandos o el procedimiento almacenado registrado se ejecuta en el suscriptor cuando se produce un cambio en el 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 la secuencia de comandos que se registra. type es de tipo varchar(16), no tiene ningún valor predeterminado y puede tener uno de los siguientes valores.

  Valor	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.
  delete	El procedimiento almacenado personalizado registrado se ejecuta cuando se replica una instrucción DELETE.
  custom_script	La secuencia de comandos 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 secuencias de comandos de Transact-SQL que se está registrando. value es de tipo nvarchar(1024) y no tiene ningún valor predeterminado.

  [!NOTA] Si se especifica NULL en el parámetro value, se eliminará del registro una secuencia de comandos registrada con anterioridad, lo que equivale a ejecutar sp_unregister_custom_scripting.

  Cuando el valor de type es custom_script, se espera el nombre y la ruta de acceso completa de un archivo de secuencias de comandos de Transact-SQL. De lo contrario, value 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 la secuencia de comandos. publication es de tipo sysname y su valor predeterminado es NULL.

• [ @article= ] 'article'
  Nombre del artículo para el que se está registrando el procedimiento almacenado personalizado o la secuencia de comandos. article es de tipo sysname y su valor predeterminado es NULL.

Notas

sp_register_custom_scripting se utiliza en la réplica de instantáneas y transaccional.

Se debe ejecutar este procedimiento almacenado antes de realizar un cambio en el esquema en una tabla replicada. Para obtener más información acerca del uso de este procedimiento almacenado, vea Volver a generar procedimientos transaccionales personalizados para reflejar cambios de esquema.

Permisos

Sólo los miembros de la función fija de servidor sysadmin o las funciones fijas de base de datos db_owner o db_ddladmin pueden ejecutar sp_register_custom_scripting.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_unregister_custom_scripting (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005