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 définition pour 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 = ] N'value'
    [ , [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
[ ; ]

Arguments

[ @type = ] 'type'

Type de procédure stockée personnalisée ou de script inscrit. @type est varchar(16) et peut être l’une des valeurs suivantes.

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

[ @value = ] N’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. @value est nvarchar(2048), sans valeur par défaut.

La spécification NULL de @value annule l’inscription d’un script précédemment inscrit, qui est identique à l’exécution de sp_unregister_custom_scripting.

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

[ @publication = ] N’publication'

Nom de la publication dont la procédure stockée ou le script personnalisé est en cours d'inscription. @publication est sysname, avec la valeur par défaut NULL.

[ @article = ] N’article'

Nom de l'article dont la procédure stockée ou le script personnalisé est en cours d'inscription. @article est sysname, avec la valeur par défaut NULL.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

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

Cette procédure stockée doit être exécuté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 les articles transactionnels - Régénérer pour refléter les 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 s’exécuter sp_register_custom_scripting.

Contenu connexe