sp_register_custom_scripting (Transact-SQL)

La réplication permet aux procédures stockées personnalisées définies par l'utilisateur de remplacer une ou plusieurs procédures par défaut utilisées dans la réplication transactionnelle. Lorsqu'une modification de schéma est apportée à une table répliquée, ces procédures stockées sont recréées. sp_register_custom_scripting inscrit une procédure stockée ou un fichier de script Transact-SQL qui est exécuté lorsqu'une modification de schéma se produit pour créer le script de la définition d'une nouvelle procédure stockée personnalisée. Cette nouvelle procédure stockée personnalisée définie par l'utilisateur doit refléter le nouveau schéma de la table. sp_register_custom_scripting est exécutée sur la base de données de publication du serveur de publication, et le fichier de script ou la procédure stockée inscrit est exécuté sur l'Abonné lorsqu'une modification de schéma se produit.

Conventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

• [ @type = ] 'type'
  Type de la procédure stockée ou du script personnalisé en cours d'inscription. type est de type varchar(16), ne possède aucune valeur par défaut et peut prendre l'une des valeurs suivantes.

  Valeur	Description
  insert	La procédure stockée personnalisée inscrite est exécutée lorsqu'une instruction INSERT est répliquée.
  update	La procédure stockée personnalisée inscrite est exécutée lorsqu'une instruction UPDATE est répliquée.
  delete	La procédure stockée personnalisée inscrite est exécutée lorsqu'une instruction DELETE est répliquée.
  custom_script	Le script est exécuté à la fin du déclencheur DDL (Data Definition Language).

• [ @value= ] 'value'
  Nom d'une procédure stockée ou nom et chemin d'accès complet du fichier de script Transact-SQL en cours d'inscription. value est de type nvarchar(1024) et n'a pas de valeur par défaut.

  Remarque :
  L'attribution de NULL au paramètre valueannule l'inscription d'un script précédemment enregistré, ce qui revient à exécuter sp_unregister_custom_scripting.

  Lorsque la valeur de type est custom_script, le nom et le chemin d'accès complet d'un fichier de script Transact-SQL sont attendus. Sinon, value doit être le nom d'une procédure stockée inscrite.

• [ @publication = ] 'publication'
  Nom de la publication dont la procédure stockée ou le script personnalisé est en cours d'inscription. L'argument publication est de type sysname, avec NULL comme valeur par défaut.

• [ @article = ] 'article'
  Nom de l'article dont la procédure stockée ou le script personnalisé est en cours d'inscription. L'argument article est de type sysname, avec NULL comme valeur par défaut.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

sp_register_custom_scripting est utilisée lors d'une réplication transactionnelle et de capture instantanée.

Vous devez exécuter cette procédure stockée avant d'apporter une modification de schéma à une table répliquée. Pour plus d'informations sur l'utilisation de cette procédure stockée, consultez Régénération de procédures transactionnelles personnalisées pour refléter des modifications de schéma.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin ou des rôles de base de données fixes db_owner ou db_ddladmin peuvent exécuter sp_register_custom_scripting.

Voir aussi

Référence

sp_unregister_custom_scripting (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005