sp_helpmergepullsubscription (Transact-SQL)

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

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

Синтаксис

sp_helpmergepullsubscription [ [ @publication=] 'publication']
    [ , [ @publisher=] 'publisher']
    [ , [ @publisher_db=] 'publisher_db']
    [ , [ @subscription_type=] 'subscription_type']

Аргументы

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

  • [ @publisher=] 'publisher'
    Имя издателя. Аргумент publisher имеет тип sysname и значение по умолчанию %.

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

  • [ @subscription_type=] 'subscription_type'
    Указание, отображать ли подписки по запросу. Аргумент subscription_type имеет тип nvarchar(10) и значение по умолчанию 'pull'. Допустимые значения: 'push' (принудительные), 'pull' (по запросу) или 'both' (обоих типов).

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

Имя столбца

Тип данных

Описание

subscription_name

nvarchar(1000)

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

publication

sysname

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

publisher

sysname

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

publisher_db

sysname

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

subscriber

sysname

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

subscription_db

sysname

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

status

int

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

0 = неактивная подписка.

1 = активная подписка.

2 = удаленная подписка.

3 = отключенная подписка.

4 = подключенная подписка.

5 = подписка помечена для повторной инициализации с передачей.

6 = сбой подключения подписки.

7 = подписка, восстановленная из резервной копии.

subscriber_type

int

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

1 = глобальный.

2 = локальный.

3 = анонимный.

subscription_type

int

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

0 = принудительная.

1 = по запросу.

2 = анонимная.

priority

float(8)

Приоритет подписки. Значение должно быть меньше 100,00.

sync_type

tinyint

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

1 = автоматическая.

2 = без использования моментального снимка.

description

nvarchar(255)

Краткое описание подписки по запросу.

merge_jobid

binary(16)

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

enabled_for_syncmgr

int

Может ли подписка быть синхронизирована при помощи диспетчера синхронизации Майкрософт.

last_updated

nvarchar(26)

Время последней успешной синхронизации подписки агентом слияния.

publisher_login

sysname

Имя входа издателя.

publisher_password

sysname

Пароль издателя.

publisher_security_mode

int

Указывает режим безопасности издателя:

0 = проверка подлинности SQL Server.

1 = проверка подлинности Windows.

distributor

sysname

Имя распространителя.

distributor_login

sysname

Имя входа распространителя.

distributor_password

sysname

Пароль распространителя.

distributor_security_mode

int

Указывает режим безопасности распространителя:

0 = проверка подлинности SQL Server.

1 = проверка подлинности Windows.

ftp_address

sysname

Приводится только для обратной совместимости. Сетевой адрес службы протокола передачи файлов FTP распространителя.

ftp_port

int

Приводится только для обратной совместимости. Номер порта службы FTP распространителя.

ftp_login

sysname

Приводится только для обратной совместимости. Имя пользователя, используемое для подключения к службе FTP.

ftp_password

sysname

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

alt_snapshot_folder

nvarchar(255)

Размещение папки с моментальными снимками, если оно отличается от размещения по умолчанию или указано в дополнение к нему.

working_directory

nvarchar(255)

Полный путь к каталогу, куда передаются файлы моментальных снимков по протоколу FTP, если указан соответствующий параметр.

use_ftp

bit

Подписка на публикацию осуществляется через Интернет, также настраиваются свойства адреса FTP. Если значение равно 0, протокол FTP в подписке не используется. Если равно 1, протокол FTP в подписке используется.

offload_agent

bit

Указывает, может ли агент быть активирован и запущен удаленно. Если значение равно 0, агент не может быть активирован удаленно.

offload_server

sysname

Имя сервера, используемого для удаленной активации.

use_interactive_resolver

int

Показывает, используется ли интерактивный арбитр конфликтов в процессе согласования. Если значение равно 0, интерактивный арбитр конфликтов не используется.

subid

uniqueidentifier

Идентификатор подписчика.

dynamic_snapshot_location

nvarchar(255)

Путь к папке, в которой сохраняются файлы моментальных снимков.

last_sync_status

int

Состояние синхронизации:

1 = запуск.

2 = выполнено.

3 = выполняется.

4 = бездействие.

5 = повтор после сбоя.

6 = сбой.

7 = сбой проверки.

8 = проверка пройдена.

9 = запрошено завершение работы.

last_sync_summary

sysname

Описание результатов последней синхронизации.

use_web_sync

bit

Указывает, может ли подписка быть синхронизирована по протоколу HTTPS; значение 1 означает, что эта возможность включена.

internet_url

nvarchar(260)

UR-адрес, который представляет собой адрес средства прослушивания репликации для веб-синхронизации.

internet_login

nvarchar(128)

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

internet_password

nvarchar(524)

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

internet_security_mode

int

Режим проверки подлинности, используемый при подключении к серверу веб-синхронизации. Значение 1 означает проверку подлинности Windows, а значение 0 — проверку подлинности SQL Server.

internet_timeout

int

Время в секундах, оставшееся до истечения срока действия запроса веб-синхронизации.

hostname

nvarchar(128)

Указывает переопределяемое значение HOST_NAME при использовании этой функции в предложении WHERE параметризованного фильтра строк.

job_login

nvarchar(512)

Учетная запись Windows, которой пользуется агент слияния. Возвращается в формате домен\имя_пользователя.

job_password

sysname

В целях безопасности всегда возвращается значение «**********».

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

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

Замечания

Процедура sp_helpmergepullsubscription используется при репликации слиянием. В результирующем наборе дата last_updated возвращается в формате ГГГГММДД чч:мм:сс.мс.

Разрешения

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