sp_register_custom_scripting (Transact-SQL)

Dotyczy:programu SQL Server

Replikacja umożliwia niestandardowym procedurom składowanych zdefiniowanym przez użytkownika zastąpienie co najmniej jednej z domyślnych procedur używanych w replikacji transakcyjnej. Po wprowadzeniu zmiany schematu w zreplikowanej tabeli te procedury składowane zostaną ponownie utworzone.

sp_register_custom_scripting rejestruje procedurę składowaną lub plik skryptu Transact-SQL wykonywany w przypadku wystąpienia zmiany schematu w celu utworzenia skryptu definicji nowej niestandardowej procedury składowanej zdefiniowanej przez użytkownika. Ta nowa niestandardowa procedura składowana zdefiniowana przez użytkownika powinna odzwierciedlać nowy schemat tabeli. sp_register_custom_scripting program jest wykonywany w programie Publisher w bazie danych publikacji, a zarejestrowany plik skryptu lub procedura składowana jest wykonywana na subskrybentu, gdy wystąpi zmiana schematu.

Transact-SQL konwencje składni

Składnia

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

Argumenty (w programowaniu)

[ @type = ] 'typ'

Typ niestandardowej procedury składowanej lub zarejestrowanego skryptu. @type jest varchar(16) i może być jedną z następujących wartości.

Wartość	Opis
insert	Zarejestrowana niestandardowa procedura składowana jest wykonywana, gdy instrukcja INSERT jest replikowana.
update	Zarejestrowana niestandardowa procedura składowana jest wykonywana, gdy instrukcja UPDATE jest replikowana.
delete	Zarejestrowana niestandardowa procedura składowana jest wykonywana, gdy instrukcja DELETE jest replikowana.
custom_script	Skrypt jest wykonywany na końcu wyzwalacza języka definicji danych (DDL).

[ @value = ] N'value'

Nazwa procedury składowanej lub nazwy i w pełni kwalifikowana ścieżka do zarejestrowanego pliku skryptu Transact-SQL. @value to nvarchar(2048), bez wartości domyślnej.

Określenie NULL dla @value wyrejestrowania wcześniej zarejestrowanego skryptu, który jest taki sam jak uruchomiony sp_unregister_custom_scripting.

Gdy wartość @type jest custom_script, oczekiwana jest nazwa i pełna ścieżka pliku skryptu Transact-SQL. W przeciwnym razie @value musi być nazwą zarejestrowanej procedury składowanej.

[ @publication = ] N'publication'

Nazwa publikacji, dla której zarejestrowano niestandardową procedurę składowaną lub skrypt. @publication to nazwa systemu z wartością domyślną NULL.

[ @article = ] N'article'

Nazwa artykułu, dla którego jest rejestrowana niestandardowa procedura składowana lub skrypt. @article to nazwa systemu z wartością domyślną NULL.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Uwagi

sp_register_custom_scripting jest używany w replikacji migawki i transakcyjnej.

Ta procedura składowana powinna zostać wykonana przed wprowadzeniem zmiany schematu w zreplikowanej tabeli. Aby uzyskać więcej informacji na temat korzystania z tej procedury składowanej, zobacz Artykuły transakcyjne — Ponowne generowanie procedur niestandardowych w celu odzwierciedlenia zmian schematu.

Uprawnienia

Tylko członkowie stałej roli serwera sysadmin, stałej roli bazy danych db_owner lub stałej roli bazy danych db_ddladmin mogą wykonywać .sp_register_custom_scripting

Powiązana treść

• sp_unregister_custom_scripting (Transact-SQL)