sp_register_custom_scripting (Transact-SQL)

  • Article

S’applique à :SQL Server

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 exécuté lorsqu’une modification de schéma se produit pour générer un script de la définition d’une nouvelle procédure stockée personnalisée définie par l’utilisateur. 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é sur le serveur de publication sur la base de données de publication, et le fichier de script inscrit ou la procédure stockée est exécuté sur l’Abonné lorsqu’une modification de schéma se produit.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @type = ] 'type' Type de procédure stockée personnalisée ou de script inscrit. type varchar (16), sans valeur par défaut, et peut être 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.
mise à jour 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 d’un nom et chemin d’accès complet au fichier de script Transact-SQL inscrit. la valeur est nvarchar(1024), sans valeur par défaut.

Remarque

La spécification de NULL pour le paramètre valeurannule l’inscription d’un script précédemment inscrit, qui est identique à l’exécution de sp_unregister_custom_scripting.

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

[ @publication = ] 'publication' Nom de la publication pour laquelle la procédure stockée ou le script personnalisé est inscrit. la publication est sysname, avec une valeur par défaut null.

[ @article = ] 'article' Nom de l’article pour lequel la procédure stockée personnalisée ou le script est inscrit. l’article est sysname, avec une valeur par défaut null.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

sp_register_custom_scripting est utilisé dans instantané et la réplication transactionnelle.

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érer des procédures transactionnelles personnalisées pour Réflexions modifications de schéma.

Autorisations

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

Voir aussi

sp_unregister_custom_scripting (Transact-SQL)