sp_register_custom_scripting (Transact-SQL)
Si applica a: 
SQL Server
La replica consente di sostituire una o più stored procedure predefinite utilizzate per la replica transazionale con stored procedure personalizzate definite dall'utente. Quando viene apportata una modifica dello schema a una tabella replicata, queste stored procedure vengono ricreate.
sp_register_custom_scripting registra una stored procedure o un file di script Transact-SQL che viene eseguito quando si verifica una modifica dello schema per generare lo script della definizione per una nuova stored procedure personalizzata definita dall'utente. Questa nuova stored procedure personalizzata definita dall'utente deve riflettere il nuovo schema della tabella. sp_register_custom_scripting viene eseguito nel database di pubblicazione del server di pubblicazione e il file di script o la stored procedure registrata viene eseguita nel Sottoscrittore quando si verifica una modifica dello schema.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
sp_register_custom_scripting
[ @type = ] 'type'
, [ @value = ] N'value'
[ , [ @publication = ] N'publication' ]
[ , [ @article = ] N'article' ]
[ ; ]
Argomenti
[ @type = ] 'type'
Tipo di stored procedure o script personalizzati da registrare. @type è varchar(16)e può essere uno dei valori seguenti.
| valore | Descrizione |
|---|---|
insert |
La stored procedure personalizzata registrata viene eseguita quando viene replicata un'istruzione INSERT . |
update |
La stored procedure personalizzata registrata viene eseguita quando viene replicata un'istruzione UPDATE . |
delete |
La stored procedure personalizzata registrata viene eseguita quando viene replicata un'istruzione DELETE . |
custom_script |
Lo script viene eseguito alla fine del trigger DDL (Data Definition Language). |
[ @value = ] N'value'
Nome di una stored procedure o di un nome e di un percorso completo del file di script Transact-SQL in fase di registrazione. @value è nvarchar(2048), senza impostazione predefinita.
Specificando NULL per @value annullare la registrazione di uno script registrato in precedenza, che corrisponde all'esecuzione di sp_unregister_custom_scripting.
Quando il valore di @type è custom_script, è previsto il nome e il percorso completo di un file di script Transact-SQL. In caso contrario, @value deve essere il nome di una stored procedure registrata.
[ @publication = ] N'publication'
Nome della pubblicazione per cui viene registrato lo script o la stored procedure personalizzata. @publication è sysname, con il valore predefinito NULL.
[ @article = ] N'article'
Nome dell'articolo per cui viene registrato lo script o la stored procedure personalizzata. @article è sysname, con un valore predefinito .NULL
Valori del codice restituito
0 (esito positivo) o 1 (errore).
Osservazioni:
sp_register_custom_scripting viene usato nella replica snapshot e transazionale.
Questa stored procedure deve essere eseguita prima di apportare una modifica dello schema a una tabella replicata. Per altre informazioni sull'uso di questa stored procedure, vedere Articoli transazionali - Rigenera per riflettere le modifiche dello schema.
Autorizzazioni
Solo i membri del ruolo predefinito del server sysadmin, il ruolo predefinito del database db_owner o il ruolo predefinito del database db_ddladmin possono eseguire sp_register_custom_scripting.