sp_helpsubscription (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_helpsubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @destination_db = ] N'destination_db' ]
    [ , [ @found = ] found OUTPUT ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Аргументы

[ @publication = ] N'publication'

Имя связанной публикации. @publication — sysname, с значением по умолчанию%, которое возвращает все сведения о подписке для этого сервера.

[ @article = ] N'article'

Имя статьи. @article — sysname, с значением по умолчанию%, которое возвращает все сведения о подписке для выбранных публикаций и подписчиков. Если allтолько одна запись возвращается для полной подписки на публикацию.

[ @subscriber = ] N'подписчик'

Имя подписчика, на котором требуется получить сведения о подписке. @subscriber — sysname, с значением по умолчанию%, которое возвращает все сведения о подписке для выбранных публикаций и статей.

[ @destination_db = ] N'destination_db'

Имя целевой базы данных. @destination_db имеет имя sysname с значением по умолчанию%.

[ @found = ] найден выходные данные

Флаг для указания возвращаемых строк. @found — это параметр OUTPUT типа int.

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

[ @publisher = ] N'publisher'

Имя издателя. @publisher — sysname, а по умолчанию — имя текущего сервера.

@publisher не следует указывать, за исключением случаев, когда это издатель Oracle.

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

Имя столбца Тип данных Description
subscriber sysname Имя подписчика.
publication sysname Имя публикации.
article sysname Имя статьи.
destination database sysname Имя целевой базы данных, в которую помещаются реплицируемые данные.
subscription status tinyint Состояние подписки:

0 = неактивное
1 = подписка
2 = активный
synchronization type tinyint Тип синхронизации подписки:

1 = автоматически
2 = Нет
subscription type int Тип подписки:

0 = Push
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 = не отправляет обратно.

Используется с двунаправленной репликацией транзакций. Дополнительные сведения см. в статье Bidirectional Transactional Replication.
offload_enabled bit Указывает, задано ли выполнение разгрузки агента репликации на подписчике.

Если 0агент выполняется на издателе.
Если 1агент выполняется на подписчике.
offload_server sysname Имя сервера, используемого для удаленной активации агента. Если NULLиспользуется текущая offload_server, указанная в таблице MSdistribution_agents .
dts_package_name sysname Указывает имя пакета служб DTS.
dts_package_location int Расположение пакета служб DTS, если он назначен для подписки. Если есть пакет, значение 0 указывает расположение пакета в папке distributor. Значение 1 указывает subscriberзначение .
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_helpsubscription используется в моментальном снимке и репликации транзакций.

Разрешения

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