sp_check_for_sync_trigger (Transact-SQL)

Статья
12/15/2008

Определяет, вызывается ли пользовательский триггер или хранимая процедура в контексте триггера репликации, который используется для немедленно обновляемых подписок. Эта хранимая процедура выполняется на издателе в базе данных публикации или на подписчике в базе данных подписки.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

sp_check_for_sync_trigger [ @tabid = ] 'tabid' 
    [ , [ @trigger_op = ] 'trigger_output_parameters' OUTPUT ]
    [ , [ @fonpublisher = ] fonpublisher ]

Аргументы

[@tabid = ] 'tabid'
Проверяется ли идентификатор таблицы на предмет немедленного обновления триггеров. Аргумент tabid имеет тип int и не имеет значения по умолчанию.

[@trigger_op = ] 'trigger_output_parameters' OUTPUT
Указывает, будет ли возвращаемый параметр содержать тип вызывающего триггера. Аргумент trigger_output_parameters имеет тип char(10) и может принимать одно из следующих значений:

Значение Описание

Ins

триггер INSERT

Upd

триггер UPDATE

Del

триггер DELETE

NULL (по умолчанию)

Значение	Описание
Ins	триггер INSERT
Upd	триггер UPDATE
Del	триггер DELETE
NULL (по умолчанию)

[ @fonpublisher = ] fonpublisher
Указывает место выполнения хранимой процедуры. Аргумент fonpublisher имеет тип bit и значение по умолчанию 0. Если значение равно 0, тогда выполнение происходит на подписчике, а если 1, то выполнение происходит на издателе.

Значения кодов возврата

0 указывает на то, что хранимая процедура не вызывается внутри контекста немедленно обновляющегося триггера. 1 указывает на то, что вызов происходит внутри контекста немедленно обновляющегося триггера, а тип триггера записывается в аргументе @trigger_op.

Замечания

Процедура sp_check_for_sync_trigger используется при репликации моментальных снимков, а также при репликации транзакций.

Процедура sp_check_for_sync_trigger используется для координации между репликацией и пользовательскими триггерами. Эта хранимая процедура определяет, была ли она вызвана в контексте триггера репликации. Например, можно вызвать процедуру sp_check_for_sync_trigger в теле определяемого пользователем триггера. Если процедура sp_check_for_sync_trigger возвращает значение 0, пользовательский триггер продолжает работу. Если процедура sp_check_for_sync_trigger возвращает значение 1, пользовательский триггер завершает работу. Это гарантирует, что определяемый пользователем триггер не срабатывает при обновлении таблицы триггером репликации.

Разрешения

Хранимую процедуру sp_check_for_sync_trigger может выполнять любой пользователь, обладающий разрешениями SELECT в системном представлении sys.objects.

Пример

В следующем примере показан код, который может использоваться в триггере таблицы подписчика.

DECLARE @retcode int, @trigger_op char(10), @table_id int
SELECT @table_id = object_id('tablename')
EXEC @retcode = sp_check_for_sync_trigger @table_id, @trigger_op OUTPUT
IF @retcode = 1
RETURN

Код также можно добавить в триггер таблицы издателя, это аналогичный код, однако вызов процедуры sp_check_for_sync_trigger содержит дополнительный параметр.

DECLARE @retcode int, @trigger_op char(10), @table_id int, @fonpublisher int
SELECT @table_id = object_id('tablename')
SELECT @fonpublisher = 1
EXEC @retcode = sp_check_for_sync_trigger @table_id, @trigger_op OUTPUT, @fonpublisher
IF @retcode = 1
RETURN

См. также

Другие ресурсы

Обновляемые подписки для репликации транзакций

Справка и поддержка

Получение помощи по SQL Server 2005

Share via