sp_helppullsubscription (Transact-SQL)
Отображает сведения об одной или более подписках на подписчике. Эта хранимая процедура выполняется на подписчике в базе данных подписки.
.gif "Значок ссылки на раздел")
Синтаксис
sp_helppullsubscription [ [ @publisher = ] 'publisher' ]
[ , [ @publisher_db = ] 'publisher_db' ]
[ , [ @publication = ] 'publication' ]
[ , [ @show_push = ] 'show_push' ]
Аргументы
[ @publisher=] 'publisher'
Имя удаленного сервера. Аргумент publisher имеет тип sysname и значение по умолчанию %; при этом возвращаются сведения обо всех издателях.[ @publisher_db=] 'publisher_db'
Имя базы данных издателя. Аргумент publisher_db имеет тип sysname и значение по умолчанию %; при этом возвращаются сведения обо всех базах данных издателя.[ @publication=] 'publication'
Имя публикации. Аргумент publication имеет тип sysname и значение по умолчанию %; при этом возвращаются все публикации. Если значение этого аргумента равно ALL, то возвращаются только подписки по запросу, для которых independent_agent = 0.[ @show_push=] 'show_push'
Должны ли быть возвращены все принудительные подписки. Аргумент show_push имеет тип nvarchar(5) и значение по умолчанию FALSE, при котором принудительные подписки не возвращаются.
Результирующие наборы
Имя столбца |
Тип данных |
Описание |
|---|---|---|
publisher |
sysname |
Имя издателя. |
publisher database |
sysname |
Имя базы данных издателя. |
publication |
sysname |
Имя публикации. |
independent_agent |
bit |
Указывает, имеется ли для данной публикации изолированный агент распространителя. |
subscription type |
int |
Тип подписки для публикации. |
distribution agent |
nvarchar(100) |
Агент распространителя, управляющий подпиской. |
publication description |
nvarchar(255) |
Описание публикации. |
last updating time |
date |
Время последнего обновления сведений о подписке. Строка в формате Юникод с датой ISO (114) + время ODBC (121). Формат «ггггммдд чч:мн:ссс.ммм», где «гггг» — год, «мм» — месяц, «дд» — день, «чч» — час, «мн» — минуты, «ссс» — секунды и «ммм» — миллисекунды. |
subscription name |
varchar(386) |
Имя подписки. |
last transaction timestamp |
varbinary(16) |
Временная метка последней реплицированной транзакции. |
update mode |
tinyint |
Тип допустимых обновлений. |
distribution agent job_id |
int |
Идентификатор задания агента распространителя. |
enabled_for_synmgr |
int |
Указание, может ли подписка быть синхронизирована с помощью диспетчера синхронизации Майкрософт. |
subscription guid |
binary(16) |
Глобальный идентификатор версии подписки в публикации. |
subid |
binary(16) |
Глобальный идентификатор для анонимной подписки. |
immediate_sync |
bit |
Указывает, выполняется ли создание (повторное создание) файлов синхронизации при каждом запуске агента моментальных снимков. |
publisher login |
sysname |
Идентификатор входа, используемый на издателе для проверки подлинности SQL Server. |
publisher password |
nvarchar(524) |
Пароль (шифрованный), используемый на издателе для проверки подлинности SQL Server. |
publisher security_mode |
int |
Режим безопасности, реализованный на издателе: 0 = проверка подлинности SQL Server. 1 = проверка подлинности Windows. 2 = Триггеры синхронизации используют статический вход sysservers для выполнения удаленного вызова процедур и параметр publisher должен быть определен в таблице sysservers как удаленный сервер или связанный сервер. |
distributor |
sysname |
Имя распространителя. |
distributor_login |
sysname |
Идентификатор входа, используемый на распространителе для проверки подлинности SQL Server. |
distributor_password |
nvarchar(524) |
Пароль (шифрованный), используемый на распространителе для проверки подлинности SQL Server. |
distributor_security_mode |
int |
Режим безопасности, реализованный на распространителе: 0 = проверка подлинности SQL Server. 1 = проверка подлинности Windows. |
ftp_address |
sysname |
Только для обратной совместимости. |
ftp_port |
int |
Только для обратной совместимости. |
ftp_login |
sysname |
Только для обратной совместимости. |
ftp_password |
nvarchar(524) |
Только для обратной совместимости. |
alt_snapshot_folder |
nvarchar(255) |
Место, где размещается папка моментального снимка, если размещение отличается от размещения по умолчанию или задано дополнительно. |
working_directory |
nvarchar(255) |
Абсолютный путь к каталогу, куда были переданы файлы моментального снимка с использованием FTP, если эта установка включена. |
use_ftp |
bit |
Подписка на публикацию осуществляется через Интернет. При этом настроены параметры адресации через FTP. Если 0, подписка не использует протокол FTP. Если 1, подписка использует протокол FTP. |
publication_type |
int |
Задает тип репликации для публикации: 0 = репликация транзакций. 1 = репликация моментальных снимков. 2 = репликация слиянием. |
dts_package_name |
sysname |
Указывает имя пакета служб DTS. |
dts_package_location |
int |
Местоположение, где хранится пакет служб DTS: 0 = распространитель. 1 = подписчик. |
offload_agent |
bit |
Указывает, может ли агент быть активирован удаленно. Если равно 0, агент не может быть активирован удаленно. |
offload_server |
sysname |
Указывает сетевое имя сервера, используемого для удаленной активации. |
last_sync_status |
int |
Состояние подписки: 0 = все задания ожидают запуска. 1 = одно или более заданий запущены. 2 = все задания выполнены успешно. 3 = по крайней мере одно задание выполняется. 4 = все задания стоят в очереди на выполнение и бездействуют. 5 = по крайней мере одно задание производит попытку запуска после предыдущего сбоя. 6 = по крайней мере одному заданию не удалось выполниться успешно. |
last_sync_summary |
sysname |
Описание последних результатов синхронизации. |
last_sync_time |
datetime |
Время последнего обновления сведений о подписке. Строка в формате Юникод с датой ISO (114) + время ODBC (121). Формат «ггггммдд чч:мн:ссс.ммм», где «гггг» — год, «мм» — месяц, «дд» — день, «чч» — час, «мн» — минуты, «ссс» — секунды и «ммм» — миллисекунды. |
job_login |
nvarchar(512) |
Учетная запись Windows, под которой запущен агент распространителя и которая возвращается в формате domain\username. |
job_password |
sysname |
В целях безопасности всегда возвращается значение «**********». |
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Замечания
Процедура sp_helppullsubscription используется при репликации моментальных снимков и транзакций.
Разрешения
Только члены предопределенной роли сервера sysadmin или предопределенной роли базы данных db_owner могут выполнить процедуру sp_helppullsubscription.