sp_helpsubscription (Transact-SQL)

Статья
05/08/2013

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

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

Синтаксис

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, и является выходным параметром со значением по умолчанию 23456.

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

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

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

Примечание
Аргумент publisher не нужно указывать, за исключением случая, когда издателем является издатель Oracle.

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

подписчик

sysname

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

публикация

sysname

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

article

sysname

Имя статьи.

destination database

sysname

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

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

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 в базе данных публикации.