sp_helpsubscription (Transact-SQL)

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

Синтаксические обозначения в 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.

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

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

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

Имя столбца

Тип данных

Описание

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.

Замечания

Хранимая процедура sp_helplogreader_agent используется в репликации моментальных снимков и репликации транзакций.

Разрешения

Разрешения на выполнение по умолчанию принадлежат роли public. Пользователям всего лишь возвращаются сведения о подписках, которые они создали. Сведения по всем подпискам возвращаются членам фиксированной серверной роли sysadmin на издателе или членам фиксированной роли базы данных db_owner в базе данных публикации.

См. также

Справочник

sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005