sp_helppublication (Transact-SQL)

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

Синтаксические обозначения в Transact-SQL

Синтаксис

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

Аргументы

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

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

• [ @publisher = ] 'publisher'
  Задает издатель, отличный от SQL Server. Аргумент publisher имеет тип sysname и значение по умолчанию NULL.

  Примечание.
  Аргумент publisher не следует указывать при запросе сведений о публикации на издателе SQL Server.

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

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

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

Имя столбца

Тип данных

Описание

pubid

int

Идентификатор публикации.

name

sysname

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

restricted

int

Зарезервировано для последующего использования.

status

tinyint

Текущее состояние публикации.

0 = Неактивна.

1 = Активна.

task

 

Используется для обратной совместимости.

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, в формат Microsoft САВ. 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 = для хранения транзакций используется компонент Microsoft Message Queuing;

sql = для хранения транзакций используется SQL Server.

Примечание.

Компонент Message Queuing больше не поддерживается.

backward_comp_level

 

Уровень совместимости базы данных. Может иметь одно из следующих значений:

10 = Microsoft SQL Server 7.0

20 = SQL Server 7.0 с пакетом обновления 1

30 = SQL Server 7.0 с пакетом обновления 2

35 = SQL Server 7.0 с пакетом обновления 3

40 = Microsoft SQL Server 2000

50 = SQL Server 2000 с пакетом обновления 1

60 = SQL Server 2000 с пакетом обновления 3

90 = Microsoft SQL Server 2005

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 = публикация поддерживает одноранговую репликацию. Дополнительные сведения см. в разделе Одноранговая репликация транзакций.

publish_local_changes_only

int

Только для внутреннего использования.

enabled_for_het_sub

int

Указывает, поддерживает ли публикация подписчиков, отличных от SQL Server. 1 = подписчики, отличные от SQL Server, поддерживаются. 0 = поддерживаются только подписчики SQL Server. Дополнительные сведения см. в разделе Подписчики, отличные от подписчиков SQL Server.

Замечания

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

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

Разрешения

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

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

Пример

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

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

См. также

Справочник

sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL)
sp_droppublication (Transact-SQL)
Хранимые процедуры репликации (Transact-SQL)

Другие ресурсы

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)

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

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