Поделиться через


sp_helpmergesubscription (Transact-SQL)

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

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

Синтаксис

sp_helpmergesubscription [ [ @publication=] 'publication']
    [ , [ @subscriber=] 'subscriber']
    [ , [ @subscriber_db=] 'subscriber_db']
    [ , [ @publisher=] 'publisher']
    [ , [ @publisher_db=] 'publisher_db']
    [ , [ @subscription_type=] 'subscription_type']
    [ , [ @found=] 'found' OUTPUT]

Аргументы

  • [ @publication=] 'publication'
    Имя публикации. Аргумент publication имеет тип sysname и значение по умолчанию %. Публикация уже должна существовать и соответствовать правилам идентификаторов. Если этот аргумент равен NULL или %, возвращаются сведения обо всех публикациях слиянием и подписках в текущей базе данных.

  • [ @subscriber=] 'subscriber'
    Имя подписчика. Аргумент subscriber имеет тип sysname и значение по умолчанию %. Если этот аргумент равен NULL или %, возвращаются сведения обо всех подписках данной публикации.

  • [ @subscriber_db=] 'subscriber_db'
    Имя базы данных подписки. Аргумент subscriber_dbимеет тип sysname и значение по умолчанию %, которое возвращает все базы данных подписок.

  • [ @publisher=] 'publisher'
    Имя издателя. Издатель должен быть действительным сервером. Аргумент publisherимеет тип sysname и значение по умолчанию %; при этом возвращаются сведения обо всех издателях.

  • [ @publisher_db=] 'publisher_db'
    Имя базы данных издателя. Аргумент publisher_dbимеет тип sysname и значение по умолчанию %, которое возвращает сведения обо всех базах данных издателя.

  • [ @subscription_type=] 'subscription_type'
    Тип подписки. Аргумент subscription_typeимеет тип nvarchar(15) и может принимать одно из следующих значений.

    Значение

    Описание

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

    Принудительная подписка

    получение по запросу

    Подписка по запросу

    both

    Обе подписки: по запросу и принудительная подписка

  • [ @found=] 'found'OUTPUT
    Флаг для указания возвращаемых строк. Аргумент foundимеет тип int и параметр OUTPUT со значением по умолчанию NULL. Значение 1 показывает, что публикация найдена. Значение 0 показывает, что публикация не найдена.

Результирующие наборы

Имя столбца

Тип данных

Описание

subscription_name

sysname

Имя подписки.

publication

sysname

Имя публикации.

publisher

sysname

Имя издателя.

publisher_db

sysname

Имя базы данных издателя.

subscriber

sysname

Имя подписчика.

subscriber_db

sysname

Имя базы данных подписки.

status

int

Состояние подписки.

0 = все задания ожидают запуска.

1 = одно или более заданий запускаются.

2 = все задания выполнены успешно.

3 = по крайней мере одно задание выполняется.

4 = все задания стоят в очереди на выполнение по расписанию и бездействуют.

5 = по крайней мере одно задание производит попытку запуска после предыдущего сбоя.

6 = по крайней мере одно задание завершилось неудачно.

subscriber_type

int

Тип подписчика.

subscription_type

int

Тип подписки:

0 = принудительный

1 = по запросу

2 = оба типа

priority

float(8)

Число, показывающее приоритет подписки.

sync_type

tinyint

Тип синхронизации подписки.

description

nvarchar(255)

Короткое описание данной подписки слиянием.

merge_jobid

binary(16)

Идентификатор задания агента слияния.

full_publication

tinyint

Подписка к полной или фильтрованной публикации.

offload_enabled

bit

Указывает, установлено ли на запуск выполнение разгрузки агента репликации на подписчике. Если равно NULL, выполняется на издателе.

offload_server

sysname

Имя сервера, на который запущен агент.

use_interactive_resolver

int

Возвращает сведения о том, был ли использован интерактивный сопоставитель во время взаимодействия. Если равно 0, интерактивный сопоставитель не используется.

hostname

sysname

Значение задается, если подписка фильтруется по значению функции HOST_NAME.

subscriber_security_mode

smallint

Режим безопасности на подписчике, где 1 означает проверку подлинности Windows, а 0 означает проверку подлинности Microsoft SQL Server.

subscriber_login

sysname

Имя входа на подписчике.

subscriber_password

sysname

Настоящий пароль подписчика никогда не возвращается. Результат скрывается строкой «******».

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

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

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

Для анонимных подписок значение столбца subscription_type всегда равно 1 (по запросу). Однако необходимо выполнить sp_helpmergepullsubscription на подписчике для получения сведений по анонимным подпискам.

Разрешения

Только члены предопределенной роли сервера sysadmin, предопределенной роли базы данных db_owner или находящиеся в списке доступа публикации могут выполнять процедуру sp_helpmergesubscription.

См. также

Справочник

sp_addmergesubscription (Transact-SQL)

sp_changemergesubscription (Transact-SQL)

sp_dropmergesubscription (Transact-SQL)

Системные хранимые процедуры (Transact-SQL)