sp_helppublication (Transact-SQL)

Статья
04/26/2023

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

Возвращает сведения о публикации. Для публикации Microsoft SQL Server эта хранимая процедура выполняется на издателе в базе данных публикации. В публикации Oracle эта хранимая процедура выполняется в распространителе для любой базы данных.

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

Синтаксис

  
sp_helppublication [ [ @publication = ] 'publication' ]  
    [ , [ @found=] found OUTPUT]  
    [ , [ @publisher = ] 'publisher' ]

Аргументы

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

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

[ @publisher = ] 'publisher' Указывает издателя, отличного от SQL Server. publisher имеет имя sysname с значением NULL по умолчанию.

Заметка

издатель не должен указываться при запросе сведений о публикации из издателя SQL Server.

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

Имя столбца	Тип данных	Описание:
pubid	int	Идентификатор публикации.
name	sysname	Имя публикации.
restricted	int	Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.
состояние	tinyint	Текущее состояние публикации. 0 = неактивный. 1 = активный.
SqlAzureDacpacDeployment		Используется для обратной совместимости.
replication frequency	tinyint	Тип частоты репликации: 0 = Транзакционный 1 = моментальный снимок
synchronization method	tinyint	Режим синхронизации: 0 = собственная программа массового копирования (служебная программа bcp ) 1 = массовое копирование символов 3 = одновременный, что означает, что используется собственная массовая копия (служебная программа bcp), но таблицы не блокируются во время моментального снимка. 4 = Concurrent_c, что означает, что массовое копирование символов используется, но таблицы не блокируются во время моментального снимка.
description	nvarchar(255)	Дополнительное описание публикации.
immediate_sync	bit	Указывает, выполняется ли создание (повторное создание) файлов синхронизации при каждом запуске агента моментальных снимков.
enabled_for_internet	bit	Указывает доступность файлов синхронизации для публикации через Интернет по протоколу FTP, а также их доступность для других служб.
allow_push	bit	Указывает, разрешена ли для данной публикации принудительная подписка.
allow_pull	bit	Указывает, разрешена ли для данной публикации подписка по запросу.
allow_anonymous	bit	Указывает, разрешена ли для данной публикации анонимная подписка.
independent_agent	bit	Указывает, есть ли у данной публикации изолированный агент распространителя.
immediate_sync_ready	bit	Указывает готовность агента моментальных снимков к работе с новыми подписками. Этот аргумент задается только в том случае, если в данной публикации моментальный снимок всегда доступен для новых или повторно инициализированных подписок.
allow_sync_tran	bit	Определяет, разрешены ли в публикации немедленно обновляемые подписки.
autogen_sync_procs	bit	Указывает, будут ли автоматически создаваться хранимые процедуры для поддержки немедленно обновляемых подписок.
snapshot_jobid	binary(16)	Идентификатор запланированной задачи.
retention	int	Сохраняемый объем изменений данной публикации в часах.
has subscription	bit	Указывает, есть ли у публикации активные подписки. 1 означает, что публикация имеет активные подписки, и 0 означает, что публикация не имеет подписок.
allow_queued_tran	bit	Указывает, разрешено ли накопление изменений в подписчике в очереди до тех пор, пока их можно применить к издателю. Если значение 0, изменения на подписчике не помещаются в очередь.
snapshot_in_defaultfolder	bit	Указывает, хранятся ли файлы моментальных снимков в папке по умолчанию. Если значение 0, файлы моментальных снимков хранятся в альтернативном расположении, указанном alternate_snapshot_folder. Если 1, файлы моментальных снимков можно найти в папке по умолчанию.
alt_snapshot_folder	nvarchar(255)	Указывает местоположение альтернативной папки для моментального снимка.
pre_snapshot_script	nvarchar(255)	Указывает указатель на расположение SQL-файла . Если моментальный снимок применяется на подписчике, то агент распространителя запускает предварительный скрипт моментального снимка до выполнения скриптов реплицируемых объектов.
post_snapshot_script	nvarchar(255)	Указывает указатель на расположение SQL-файла . Агент распространителя запускает заключительный скрипт после применения скриптов и данных всех реплицируемых объектов во время первоначальной синхронизации.
compress_snapshot	bit	Указывает, что моментальный снимок, записанный в расположение alt_snapshot_folder , должен быть сжатым в формате CAB Майкрософт. 0 указывает, что моментальный снимок не будет сжиматься.
ftp_address	sysname	Сетевой адрес службы FTP для распространителя. Указывает расположение файлов моментальных снимков публикаций для агента распространителя или агента слияния подписчика.
ftp_port	int	Номер порта службы FTP для распространителя.
ftp_subdirectory	nvarchar(255)	Указывает расположение файлов моментальных снимков для агента распространителя или агента слияния данного подписчика, если публикация поддерживает распространение моментальных снимков с помощью FTP.
ftp_login	sysname	Имя пользователя для подключения к службе FTP.
allow_dts	bit	Указывает, что в публикации разрешены преобразования данных. 0 указывает, что преобразования DTS запрещены.
allow_subscription_copy	bit	Указывает, разрешено ли копирование баз данных подписки, подписанных на данную публикацию. 0 означает, что копирование запрещено.
centralized_conflicts	bit	Определяет, хранятся ли на издателе конфликтные записи. 0 = записи конфликтов хранятся как у издателя, так и у подписчика, вызвавшего конфликт. 1 = записи конфликтов хранятся на издателе.
conflict_retention	int	Задает срок хранения конфликтных записей в днях.
conflict_policy	int	Задает политику устранения конфликтов при обновлении подписчика посредством очередей. Может принимать одно из следующих значений: 1 = издатель выигрывает конфликт. 2 = подписчик выигрывает конфликт. 3 = подписка повторно инициализирована.
queue_type		Задает используемый тип очереди. Может принимать одно из следующих значений: msmq = использование очереди сообщений Майкрософт для хранения транзакций. sql = использование SQL Server для хранения транзакций. Примечание. Поддержка очереди сообщений прекращена.
backward_comp_level		Уровень совместимости базы данных. Может иметь одно из следующих значений: 90 = Microsoft SQL Server 2005 (9.x) 100 = Microsoft SQL Server 2008 (10.0.x)
publish_to_AD	bit	Указывает, публикуется ли публикация в Microsoft Active Directory. Значение 1 указывает на то, что она опубликована, а значение 0 указывает, что она не опубликована.
allow_initialize_from_backup	bit	Показывает, может ли подписчик инициализировать подписку на эту публикацию из резервной копии, а не из исходного моментального снимка. 1 означает, что подписки можно инициализировать из резервной копии, и 0 означает, что они не могут. Дополнительные сведения см. в статье Инициализация подписки транзакций без моментального снимка подписчика транзакций без моментального снимка .
replicate_ddl	int	Указывает, поддерживается ли для публикации репликация схемы. 1 указывает, что операторы языка определения данных (DDL), выполняемые на издателе, реплицируются, и 0 указывает, что инструкции DDL не реплицируются. Дополнительные сведения см. в статье Внесение изменений в схемы баз данных публикации.
enabled_for_p2p	int	Указывает, может ли публикация использоваться в одноранговой топологии репликации. 1 указывает, что публикация поддерживает одноранговую репликацию. Дополнительные сведения см. в разделе Peer-to-Peer Transactional Replication.
publish_local_changes_only	int	Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.
enabled_for_het_sub	int	Указывает, поддерживает ли публикация подписчиков, отличных от SQL Server. Значение 1 означает, что подписчики, отличные от SQL Server, поддерживаются. Значение 0 означает, что поддерживаются только подписчики SQL Server. Дополнительные сведения см. в статье Non-SQL Server Subscribers.
enabled_for_p2p_conflictdetection	int	Определяет, будет ли агент распространителя обнаруживать конфликты публикации, разрешенной для одноранговой репликации. Значение 1 означает, что обнаружены конфликты. Дополнительные сведения см. в разделе Conflict Detection in Peer-to-Peer Replication.
originator_id	int	Указывает идентификатор в одноранговой топологии. Этот идентификатор используется для обнаружения конфликтов, если enabled_for_p2p_conflictdetection имеет значение 1. Список использованных идентификаторов запросите в системной таблице Mspeer_originatorid_history .
p2p_continue_onconflict	int	Указывает, продолжает ли агент распространителя обрабатывать изменения при обнаружении конфликта. Значение 1 означает, что агент продолжает обрабатывать изменения. Внимание Рекомендуется использовать значение по умолчанию 0. Если для этого параметра задано значение 1, агент распространителя пытается конвергентировать данные в топологии, применяя конфликтующую строку с узла с самым высоким идентификатором источника. Этот метод не гарантирует конвергенции. После обнаружения конфликта следует убедиться, что топология остается согласованной. Дополнительные сведения см. в подразделе «Обработка конфликтов» раздела Conflict Detection in Peer-to-Peer Replication.
allow_partition_switch	int	Указывает, следует ли ALTER TABLE... Инструкции SWITCH можно выполнять в опубликованной базе данных. Дополнительные сведения см. в статье Replicate Partitioned Tables and Indexes (Репликация секционированных таблиц и индексов).
replicate_partition_switch	int	Указывает, следует ли ALTER TABLE... Инструкции SWITCH, выполняемые в опубликованной базе данных, должны быть реплицированы в подписчиков. Этот параметр действителен только в том случае, если для allow_partition_switch задано значение 1.
enabled_for_p2p_lastwriter_conflictdetection	int	Начиная с SQL Server 2019 (15.x) CU 13, указывает, обнаруживает ли агент распространителя конфликты последней записи для публикации, которая включена для одноранговой репликации. Значение 1 означает, что обнаружены последние конфликты записи.

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

0 (успешно) или 1 (сбой)

Замечания

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

Процедура sp_helppublication возвращает сведения обо всех публикациях, которые принадлежат пользователю, выполняющему эту процедуру.

пример

DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran' 

USE [AdventureWorks2022]
EXEC sp_helppublication @publication = @myTranPub
GO

Разрешения

Процедуру sp_helppublication могут выполнять только члены предопределенной роли сервера sysadmin на издателе, члены предопределенной роли базы данных db_owner в базе данных публикации, а также пользователи из списка доступа к публикации (PAL).

Для издателя, отличного от SQL Server, только члены предопределенных ролей сервера sysadmin на распространителе или членах предопределенных ролей базы данных db_owner в базе данных распространителя или пользователей в PAL могут выполняться sp_helppublication.

См. также

Просмотр и изменение свойств публикации
sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL)
sp_droppublication (Transact-SQL)
Хранимые процедуры репликации (Transact-SQL)