sp_register_custom_scripting (Transact-SQL)sp_register_custom_scripting (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

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.Replication allows user-defined custom stored procedures to replace one or more of the default procedures used in transactional replication. Lorsqu'une modification de schéma est apportée à une table répliquée, ces procédures stockées sont recréées.When a schema change is made to a replicated table, these stored procedures are re-created. sp_register_custom_scripting inscrit une procédure stockée ou Transact-SQLTransact-SQL fichier de script qui est exécuté lorsqu’une modification de schéma se produit au script de la définition d’une nouvelle défini par l’utilisateur procédure stockée personnalisée.sp_register_custom_scripting registers a stored procedure or Transact-SQLTransact-SQL script file that is executed when a schema change occurs to script out the definition for a new user-defined custom stored procedure. Cette nouvelle procédure stockée personnalisée définie par l'utilisateur doit refléter le nouveau schéma de la table.This new user-defined custom stored procedure should reflect the new schema for the table. sp_register_custom_scripting est exécutée sur le serveur de publication sur la base de données de publication, et le fichier de script enregistré ou d’une procédure stockée est exécutée sur l’abonné lorsqu’une modification de schéma se produit.sp_register_custom_scripting is executed at the Publisher on the publication database, and the registered script file or stored procedure is executed at the Subscriber when a schema change occurs.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @type = ] 'type' Le type de procédure stockée personnalisée ou du script en cours d’inscription.[ @type = ] 'type' Is the type of custom stored procedure or script being registered. type est varchar (16) , sans valeur par défaut et peut prendre l’une des valeurs suivantes.type is varchar(16), with no default, and can be one of the following values.

ValueValue DescriptionDescription
insertinsert La procédure stockée personnalisée inscrite est exécutée lorsqu'une instruction INSERT est répliquée.Registered custom stored procedure is executed when an INSERT statement is replicated.
updateupdate La procédure stockée personnalisée inscrite est exécutée lorsqu'une instruction UPDATE est répliquée.Registered custom stored procedure is executed when an UPDATE statement is replicated.
deletedelete La procédure stockée personnalisée inscrite est exécutée lorsqu'une instruction DELETE est répliquée.Registered custom stored procedure is executed when a DELETE statement is replicated.
custom_scriptcustom_script Le script est exécuté à la fin du déclencheur DDL (Data Definition Language).Script is executed at the end of the data definition language (DDL) trigger.

[ @value = ] 'value' Nom d’une procédure stockée ou le nom et le chemin complet vers le Transact-SQLTransact-SQL fichier de script qui est en cours d’inscription.[ @value = ] 'value' Name of a stored procedure or name and fully-qualified path to the Transact-SQLTransact-SQL script file that is being registered. valeur est nvarchar (1024) , sans valeur par défaut.value is nvarchar(1024), with no default.

Notes

En spécifiant NULL pour valeurparamètre annule un script précédemment enregistré, ce qui est le même que l’exécution sp_unregister_custom_scripting.Specifying NULL for valueparameter will unregister a previously registered script, which is the same as running sp_unregister_custom_scripting.

Lorsque la valeur de type est custom_script, le nom et le chemin d’accès complet d’un Transact-SQLTransact-SQL fichier de script est attendu.When the value of type is custom_script, the name and full path of a Transact-SQLTransact-SQL script file is expected. Sinon, valeur doit être le nom d’une procédure stockée inscrit.Otherwise, value must be the name of a registered stored procedure.

[ @publication = ] 'publication' Nom de la publication pour laquelle la procédure stockée personnalisée ou un script est en cours d’inscription.[ @publication = ] 'publication' Name of the publication for which the custom stored procedure or script is being registered. publication est sysname, avec une valeur par défaut NULL.publication is sysname, with a default of NULL.

[ @article = ] 'article' Nom de l’article pour lequel la procédure stockée personnalisée ou un script est enregistré.[ @article = ] 'article' Name of the article for which the custom stored procedure or script is being registered. article est sysname, avec une valeur par défaut NULL.article is sysname, with a default of NULL.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_register_custom_scripting est utilisé dans la réplication transactionnelle et d’instantané.sp_register_custom_scripting is used in snapshot and transactional replication.

Vous devez exécuter cette procédure stockée avant d'apporter une modification de schéma à une table répliquée.This stored procedure should be executed prior to making a schema change to a replicated table. 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 refléter les modifications de schéma.For more information about using this stored procedure, see Regenerate Custom Transactional Procedures to Reflect Schema Changes.

AutorisationsPermissions

Seuls les membres de la sysadmin rôle serveur fixe le db_owner rôle de base de données fixe ou le db_ddladmin rôle de base de données fixe peuvent exécuter sp_ register_custom_scripting.Only members of the sysadmin fixed server role, the db_owner fixed database role, or the db_ddladmin fixed database role can execute sp_register_custom_scripting.

Voir aussiSee Also

sp_unregister_custom_scripting (Transact-SQL)sp_unregister_custom_scripting (Transact-SQL)