sp_register_custom_scripting (Transact-SQL)

Artikel
05/07/2013

Mithilfe der Replikation ist es möglich, eine oder mehrere der bei der Transaktionsreplikation verwendeten Standardprozeduren durch benutzerdefinierte gespeicherte Prozeduren zu ersetzen. Wenn an einer replizierten Tabelle eine Schemaänderung vorgenommen wird, werden diese gespeicherten Prozeduren neu erstellt. sp_register_custom_scripting registriert eine gespeicherte Prozedur oder eine Transact-SQL-Skriptdatei, die ausgeführt wird, wenn eine Schemaänderung erfolgt, um die Definition für eine neue, benutzerdefinierte gespeicherte Prozedur auszugeben. Diese neue, benutzerdefinierte gespeicherte Prozedur sollte das neue Schema für die Tabelle wiedergeben. sp_register_custom_scripting wird auf dem Verleger für die Veröffentlichungsdatenbank ausgeführt. Die registrierte Skriptdatei bzw. gespeicherte Prozedur wird auf dem Abonnenten ausgeführt, sobald eine Schemaänderung erfolgt.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @type = ] 'type'
Der Typ der benutzerdefinierten gespeicherten Prozedur oder des Skripts, die bzw. das registriert wird. type ist vom Datentyp varchar(16) und hat keinen Standardwert. Die folgenden Werte sind möglich:

Wert	Beschreibung
insert	Die registrierte, benutzerdefinierte gespeicherte Prozedur wird ausgeführt, wenn eine INSERT-Anweisung repliziert wird.
update	Die registrierte, benutzerdefinierte gespeicherte Prozedur wird ausgeführt, wenn eine UPDATE-Anweisung repliziert wird.
delete	Die registrierte, benutzerdefinierte gespeicherte Prozedur wird ausgeführt, wenn eine DELETE-Anweisung repliziert wird.
custom_script	Das Skript wird am Ende des DDL-Triggers (Data Definition Language) ausgeführt.

[ @value= ] 'value'
Der Name einer gespeicherten Prozedur oder der Name und vollqualifizierter Pfad der Transact-SQL-Skriptdatei, die registriert wird. value ist vom Datentyp nvarchar(1024) und hat keinen Standardwert.

Hinweis
Beim Angeben von NULL für den value-Parameter wird die Registrierung eines zuvor registrierten Skripts aufgehoben. Dies ist gleichbedeutend mit dem Ausführen von sp_unregister_custom_scripting.

Wenn type den Wert custom_script hat, werden der Name und der vollständige Pfad einer Transact-SQL-Skriptdatei erwartet. Andernfalls muss value der Name einer registrierten gespeicherten Prozedur sein.

[ @publication= ] 'publication'
Der Name der Veröffentlichung, für die die benutzerdefinierte gespeicherte Prozedur bzw. das Skript registriert wird. publication ist vom Datentyp sysname. Der Standardwert ist NULL.
[ @article= ] 'article'
Der Name des Artikels, für den die benutzerdefinierte gespeicherte Prozedur bzw. das Skript registriert wird. article ist vom Datentyp sysname. Der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_register_custom_scripting wird bei der Momentaufnahme- und Transaktionsreplikation verwendet.

Diese gespeicherte Prozedur sollte ausgeführt werden, bevor Schemaänderungen an einer replizierten Tabelle vorgenommen werden. Weitere Informationen zum Verwenden dieser gespeicherten Prozedur finden Sie unter Erneutes Generieren von Transaktionsprozeduren zur Erfassung von Schemaänderungen.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin, der festen Datenbankrolle db_owner oder der festen Datenbankrolle db_ddladmin können sp_register_custom_scripting ausführen.

Siehe auch

Verweis

sp_unregister_custom_scripting (Transact-SQL)

Freigeben über