sp_helpsubscription (Transact-SQL)
Предоставляет сведения о подписке, связанные с определенной публикацией, статьей, подписчиком или набором подписок. Эта хранимая процедура выполняется на издателе в базе данных публикации.
.gif "Значок ссылки на раздел")
Синтаксис
sp_helpsubscription [ [ @publication = ] 'publication' ]
[ , [ @article = ] 'article' ]
[ , [ @subscriber = ] 'subscriber' ]
[ , [ @destination_db = ] 'destination_db' ]
[ , [ @found=] found OUTPUT ]
[ , [ @publisher = ] 'publisher' ]
Аргументы
[ @publication=] 'publication'
Имя связанной публикации. Аргумент publication имеет тип sysname и значение по умолчанию %, при котором возвращаются все сведения о подписках для этого сервера.[ @article= ] 'article'
Имя статьи. Аргумент article имеет тип sysname и значение по умолчанию %, при котором возвращаются все сведения о подписках для выбранных публикаций и подписчиков. Если аргумент имеет значение all, возвращается только одна запись для полной подписки на публикацию.[ @subscriber=] 'subscriber'
Имя подписчика, для которого возвращаются сведения о подписке. Аргумент subscriber имеет тип sysname и значение по умолчанию %, при котором возвращаются все сведения о подписках для выбранных публикаций и статей.[ @destination_db= ] 'destination_db'
Имя целевой базы данных. Аргумент destination_db имеет тип sysname и значение по умолчанию %.[ @found= ] **'found'**OUTPUT
Флаг для указания возвращаемых строк. Аргумент found имеет тип int и параметр OUTPUT , имеющий значение по умолчанию 23456.Значение 1 показывает, что публикация найдена.
Значение 0 показывает, что публикация не найдена.
[ @publisher= ] 'publisher'
Имя издателя. Аргумент publisher имеет тип sysname и имя текущего сервера в качестве значения по умолчанию..gif "Примечание")
ПримечаниеАргумент publisher не нужно указывать, за исключением случая, когда издателем является издатель Oracle.
Результирующие наборы
Имя столбца |
Тип данных |
Описание |
|---|---|---|
subscriber |
sysname |
Имя подписчика. |
publication |
sysname |
Имя публикации. |
article |
sysname |
Имя статьи. |
destination database |
sysname |
Имя целевой базы данных, в которую помещаются реплицируемые данные. |
subscription status |
tinyint |
Состояние подписки: 0 = неактивно. 1 = подписано. 2 = активно. |
synchronization type |
tinyint |
Тип синхронизации подписки: 1 = автоматическая. 2 = отсутствует. |
subscription type |
int |
Тип подписки: 0 = принудительная. 1 = по запросу. 2 = анонимная. |
full subscription |
bit |
На все ли статьи публикации подписана данная подписка: 0 = нет. 1 = да. |
subscription name |
nvarchar(255) |
Имя подписки. |
update mode |
int |
0 = только для чтения. 1 = немедленно обновляемая подписка. |
distribution job id |
binary(16) |
Идентификатор задания агента распространителя. |
loopback_detection |
bit |
Механизм распознавания обратной связи определяет, отправляет ли агент распространителя транзакции, созданные в подписчике, обратно подписчику: 0 = отправляет обратно. 1 = не отправляет обратно. Используется с двунаправленной репликацией транзакций. Дополнительные сведения см. в разделе Двунаправленная репликация транзакций. |
offload_enabled |
bit |
Указывает, было ли установлено разгрузочное выполнение агента репликации для запуска на подписчике. Если имеет значение 0, агент выполняется на издателе. При значении 1 агент выполняется на подписчике. |
offload_server |
sysname |
Имя сервера, используемого для удаленной активации агента. Если имеет значение NULL, используется текущее значение столбца offload_server из таблицы MSDistribution_agents. |
dts_package_name |
sysname |
Указывает имя пакета служб DTS. |
dts_package_location |
int |
Расположение пакета служб DTS, если он назначен для подписки. Если пакет существует, то значение 0 указывает, что пакет находится на распространителе. Значение 1 указывает, что пакет находится на подписчике. |
subscriber_security_mode |
smallint |
Режим безопасности на подписчике. Значение 1 означает проверку подлинности Windows, а значение 0 означает проверку подлинности SQL Server. |
subscriber_login |
sysname |
Имя входа на подписчике. |
subscriber_password |
Фактический пароль подписчика никогда не возвращается. Результат скрывается строкой «******». |
|
job_login |
sysname |
Имя учетной записи Windows, под которой работает агент распространителя. |
job_password |
Фактический пароль задания никогда не возвращается. Результат скрывается строкой «******». |
|
distrib_agent_name |
nvarchar(100) |
Имя задания агента, которое синхронизирует подписку. |
subscriber_type |
tinyint |
Тип подписчика. Может быть одним из следующих.
ЗначениеОписание
0Подписчик SQL Server
1Сервер источника данных ODBC
2База данных Microsoft JET (устаревший)
3Поставщик OLE DB
|
subscriber_provider |
sysname |
Уникальный программный идентификатор (PROGID), с которым регистрируется поставщик OLE DB для источника данных, отличного от SQL Server. |
subscriber_datasource |
nvarchar(4000) |
Имя источника данных, понятное поставщику OLE DB. |
subscriber_providerstring |
nvarchar(4000) |
Идентифицирующая источник данных строка соединения, зависящая от поставщика OLE DB. |
subscriber_location |
nvarchar(4000) |
Расположение базы данных, подразумевается поставщик OLE DB. |
subscriber_catalog |
sysname |
Каталог, используемый при соединении с поставщиком OLE DB. |
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Замечания
Хранимая процедура sp_helplogreader_agent используется в репликации моментальных снимков и репликации транзакций.
Разрешения
Разрешения на выполнение по умолчанию принадлежат роли public. Пользователям всего лишь возвращаются сведения о подписках, которые они создали. Сведения по всем подпискам возвращаются членам предопределенной роли сервера sysadmin на издателе или членам предопределенной роли базы данных db_owner в базе данных публикации.