sp_register_custom_scripting (Transact-SQL)

  • Articolo

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 eseguito quando si verifica una modifica dello schema per creare uno script 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 server di pubblicazione del database di pubblicazione e il file di script o la stored procedure registrata viene eseguita nel Sottoscrittore quando si verifica una modifica dello schema.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @type = ] 'type' Tipo di stored procedure o script personalizzati da registrare. il tipo è varchar(16), senza impostazione predefinita 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 = ] '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(1024), senza impostazione predefinita.

Nota

Se si specifica NULL per il parametro value, verrà annullata la registrazione di uno script registrato in precedenza, che corrisponde all'esecuzione di sp_unregister_custom_scripting.

Quando il valore di tipo è custom_script, è previsto il nome e il percorso completo di un file di script Transact-SQL. In caso contrario, il valore deve essere il nome di una stored procedure registrata.

[ @publication = ] 'publication' Nome della pubblicazione per la quale è in corso la registrazione della stored procedure o dello script personalizzato. publication è sysname, con valore predefinito NULL.

[ @article = ] 'article' Nome dell'articolo per cui è in corso la registrazione della stored procedure o dello script personalizzato. 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 Rigenerare routine transazionali personalizzate 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 essere eseguiti sp_register_custom_scripting.

Vedi anche

sp_unregister_custom_scripting (Transact-SQL)