sp_helpmergesubscription (Transact-SQL)

  • Статья

Применимо к:SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @publication = ] N'publication'

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

[ @subscriber = ] N'подписчик'

Имя подписчика. @subscriber — sysname с значением по умолчанию%. Если NULL или %, возвращается информация обо всех подписках на данную публикацию.

[ @subscriber_db = ] N'subscriber_db'

Имя базы данных подписки. @subscriber_db — sysname, с значением по умолчанию%, которое возвращает сведения обо всех базах данных подписки.

[ @publisher = ] N'publisher'

Имя издателя. @publisher имеет имя sysname с значением по умолчанию%%, в котором возвращается информация обо всех издателях. Издатель должен быть действительным сервером.

[ @publisher_db = ] N'publisher_db'

Имя базы данных издателя. @publisher_db — sysname, с значением по умолчанию%, которое возвращает сведения обо всех базах данных издателя.

[ @subscription_type = ] N'subscription_type'

Тип подписки. @subscription_type — nvarchar(15) и может быть одним из этих значений.

значение Описание
push (по умолчанию) Принудительная подписка
pull Подписка по запросу
both Обе подписки: по запросу и принудительная подписка

[ @found = ] найден выходные данные

Флаг для указания возвращаемых строк. @found — это параметр OUTPUT типа int.

  • 1 указывает, что публикация найдена.
  • 0 указывает, что публикация не найдена.

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

Имя столбца Тип данных Description
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 = Push

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 означает проверку подлинности SQL Server.
subscriber_login sysname Имя входа на подписчике.
subscriber_password sysname Фактический пароль подписчика никогда не возвращается. Результат маскируется строкой ****** .

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

0 (успешно) или 1 (сбой).

Замечания

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

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

Разрешения

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

Связанный контент