sp_register_custom_scripting (Transact-SQL)

Tramite la replica è possibile sostituire con stored procedure personalizzate definite dall'utente una o più procedure predefinite utilizzate nella replica transazionale. 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 script Transact-SQL che viene eseguito in occasione di una modifica dello schema per inserire in uno script la definizione di 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 eseguita nel database di pubblicazione del server di pubblicazione e la stored procedure o il file script registrato viene eseguito nel Sottoscrittore in occasione di una modifica dello schema.

Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

• [ @type = ] 'type'
  Tipo di stored procedure personalizzata o script da registrare. type è di tipo varchar(16) e non prevede alcun valore predefinito. I possibili valori sono i 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 nome e percorso completo del file script Transact-SQL da registrare. value è di tipo nvarchar(1024) e non prevede alcun valore predefinito.

  [!NOTA] Se si specifica NULL per il parametro value,verrà annullata la registrazione di uno script precedentemente registrato. Il risultato è lo stesso che si ottiene eseguendo sp_unregister_custom_scripting.

  Se il valore di type è di tipo custom_script, viene atteso il nome e il percorso di un file script Transact-SQL. In alternativa value deve essere il nome di una stored procedure registrata.

• [ @publication= ] 'publication'
  Nome della pubblicazione per cui viene registrato lo script o la stored procedure personalizzata. publication è di tipo sysname e il valore predefinito è NULL.

• [ @article= ] 'article'
  Nome dell'articolo per cui viene registrato lo script o la stored procedure personalizzata. article è di tipo sysname e il valore predefinito è NULL.

Osservazioni

La stored procedure sp_register_custom_scripting viene utilizzata nella replica snapshot e transazionale.

Questa stored procedure deve essere eseguita prima di apportare una modifica dello schema a una tabella replicata. Per ulteriori informazioni sull'utilizzo di questa stored procedure, vedere Rigenerazione di procedure transazionali personalizzate per riflettere le modifiche dello schema.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin, del ruolo predefinito del database db_owner o del ruolo predefinito del database db_ddladmin possono eseguire sp_register_custom_scripting.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Riferimento

sp_unregister_custom_scripting (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005