sp_helpsubscription (Transact-SQL)

Статья
04/26/2023

Применимо к:Управляемому экземпляру SQL Server Azure

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

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

Синтаксис

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

Аргументы

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

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

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

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

[ @found = ] 'found'OUTPUT Флаг для указания возвращаемых строк. найденозначение int и параметр OUTPUT с значением по умолчанию 23456.

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

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

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

Заметка

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

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

Имя столбца	Тип данных	Описание:
subscriber	sysname	Имя подписчика.
Публикации	sysname	Имя публикации.
Статьи	sysname	Имя статьи.
целевая база данных	sysname	Имя целевой базы данных, в которую помещаются реплицируемые данные.
Состояние подписки	tinyint	Состояние подписки: 0 = неактивное 1 = подписка 2 = активный
Тип синхронизации	tinyint	Тип синхронизации подписки: 1 = автоматически 2 = Нет
Тип подписки	int	Тип подписки: 0 = Push 1 = вытягивание 2 = анонимный
полная подписка	bit	На все ли статьи публикации подписана данная подписка: 0 = Нет 1 = Да
Имя подписки	nvarchar(255)	Имя подписки.
режим обновления	int	0 = только для чтения 1 = подписка немедленного обновления
Идентификатор задания распространения	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 указывает расположение пакета на распространителю. Значение 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_helpsubscription используется в репликации моментальных снимков и транзакций.

Разрешения

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

См. также

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