sp_register_custom_scripting (Transact-SQL)

  • Artikel

Gilt für: SQL Server

Mithilfe der Replikation ist es möglich, mindestens eine 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 Transact-SQL-Skriptdatei, die ausgeführt wird, wenn eine Schemaänderung eintritt, um die Definition für eine neue benutzerdefinierte gespeicherte Prozedur zu skripten. Diese neue, benutzerdefinierte gespeicherte Prozedur sollte das neue Schema für die Tabelle wiedergeben. sp_register_custom_scripting wird bei Publisher in der Publikationsdatenbank ausgeführt, und die registrierte Skriptdatei oder gespeicherte Prozedur wird beim Abonnenten ausgeführt, wenn eine Schemaänderung auftritt.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @type = ] 'type'

Der Typ der benutzerdefinierten gespeicherten Prozedur oder des Skripts, die registriert werden. @type ist varchar(16) und kann einer der folgenden Werte sein.

Wert Beschreibung
insert Registrierte benutzerdefinierte gespeicherte Prozedur wird ausgeführt, wenn eine INSERT Anweisung repliziert wird.
update Registrierte benutzerdefinierte gespeicherte Prozedur wird ausgeführt, wenn eine UPDATE Anweisung repliziert wird.
delete 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 = ] N'value'

Name einer gespeicherten Prozedur oder eines Namens und vollqualifizierten Pfads zur Transact-SQL-Skriptdatei, die registriert wird. @value ist nvarchar(2048), ohne Standard.

Die Angabe NULL für @value hebt die Registrierung eines zuvor registrierten Skripts auf, das mit der Ausführung sp_unregister_custom_scripting identisch ist.

Wenn der Wert von @type custom_script ist, wird der Name und der vollständige Pfad einer Transact-SQL-Skriptdatei erwartet. Andernfalls muss @value der Name einer registrierten gespeicherten Prozedur sein.

[ @publication = ] N'Publikation'

Der Name der Veröffentlichung, für die die benutzerdefinierte gespeicherte Prozedur bzw. das Skript registriert wird. @publication ist "sysname" mit der Standardeinstellung "NULL.

[ @article = ] N'article'

Der Name des Artikels, für den die benutzerdefinierte gespeicherte Prozedur bzw. das Skript registriert wird. @article ist "sysname" mit der Standardeinstellung "NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_register_custom_scripting wird in der Momentaufnahme- und Transaktionsreplikation verwendet.

Diese gespeicherte Prozedur sollte ausgeführt werden, bevor eine Schemaänderung an einer replizierten Tabelle vorgenommen wird. Weitere Informationen zur Verwendung dieser gespeicherten Prozedur finden Sie in den Transaktionsartikeln – Regenerate to Reflect Schema Changes.For more information about using this stored procedure, see Transactional Articles - Regenerate to Reflect Schema Changes.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin , die db_owner feste Datenbankrolle oder die db_ddladmin festen Datenbankrolle können ausgeführt werden sp_register_custom_scripting.

Zugehöriger Inhalt