sp_helpmergepublication (Transact-SQL)

Изменения: 12 декабря 2006 г.

Возвращает данные о публикации слиянием. Эта хранимая процедура выполняется на издателе в базе данных публикации.

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

Синтаксис

sp_helpmergepublication [ [ @publication= ] 'publication']
    [ , [ @found= ] 'found'OUTPUT]
    [ , [ @publication_id= ] 'publication_id' OUTPUT]
    [ , [ @reserved= ] 'reserved' ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]

Аргументы

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

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

• [ @publication_id=] 'publication_id' OUTPUT
  Идентификационный номер публикации. Аргумент publication_id имеет тип uniqueidentifier и значение по умолчанию NULL, является аргументом OUTPUT.

• [ @reserved=] 'reserved'
  Зарезервировано для дальнейшего использования. Аргумент reserved имеет тип nvarchar(20) и значение по умолчанию NULL.

• [ @publisher = ] 'publisher'
  Имя издателя. Аргумент publisher имеет тип sysname и значение по умолчанию NULL.

• [@publisher_db = ] 'publisher_db'
  Имя базы данных публикации. Аргумент publisher_db имеет тип sysname и значение по умолчанию NULL.

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

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

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

Имя столбца

Тип данных

Описание

id

int

Порядковый номер публикации в списке результирующего набора.

name

sysname

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

description

nvarchar(255)

Описание публикации.

status

tinyint

Указывает, когда доступны данные публикации.

retention

int

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

sync_mode

tinyint

Режим синхронизации этой публикации.

0 = собственная программа массового копирования (программа bcp);

1 = символьное массовое копирование.

allow_push

int

Указывает, могут ли быть созданы принудительные подписки для указанной публикации. 0 означает, что создание принудительной подписки не разрешено.

allow_pull

int

Указывает, могут ли быть созданы подписки по запросу для указанной публикации. 0 означает, что создание подписок по запросу не разрешено.

allow_anonymous

int

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

centralized_conflicts

int

Указывает, хранятся ли конфликтные записи на данном издателе:

0 = конфликтные записи хранятся как на издателе, так и на подписчике, вызвавшем конфликт;

1 = все конфликтные записи хранятся на издателе.

priority

float(8)

Приоритет подписки с обратной передачей данных.

snapshot_ready

tinyint

Указывает, готов ли моментальный снимок этой публикации.

0 = Моментальный снимок готов к использованию

1 = Моментальный снимок не готов к использованию

publication_type

int

Тип публикации:

0 = моментальный снимок;

1 = публикация транзакций;

2 = публикация слиянием.

pubid

uniqueidentifier

Уникальный идентификатор этой публикации.

snapshot_jobid

binary(16)

Идентификатор задания агента моментальных снимков. Для получения записи задания моментального снимка в системной таблице sysjobs необходимо преобразовать шестнадцатеричное значение в тип данных uniqueidentifier.

enabled_for_internet

int

Указывает, разрешена ли публикация через Интернет. Если это значение равно 1, то файлы синхронизации для публикации вносятся в каталог C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp. Пользователю необходимо создать каталог для протокола FTP. Если это значение равно 0, то доступ к публикации через Интернет не разрешен.

dynamic_filter

int

Указывает, используется ли параметризованный фильтр строк. 0 означает, что параметризованный фильтр строк не используется.

has_subscription

bit

Указывает, имеет ли публикация подписки. 0 означает, что на данный момент на эту публикацию подписок нет.

snapshot_in_default_folder

bit

Указывает, хранятся ли файлы моментальных снимков в папке по умолчанию.

Если это значение равно 1, то файлы моментальных снимков находятся в папке по умолчанию.

Если это значение равно 0, то файлы моментальных снимков хранятся в другом месте, заданном аргументом alt_snapshot_folder. Это место может находиться на другом сервере, на сетевом диске или на съемном носителе (например на CD-ROM или на съемном диске). Сохранить файлы моментальных снимков можно также на веб-узле FTP, чтобы подписчик мог впоследствии их загрузить.

Примечание.

Этот аргумент может иметь значение True, при этом также может быть задан аргумент alt_snapshot_folder. Такое сочетание указывает, что файлы моментальных снимков хранятся как в месте размещения по умолчанию, так и в альтернативных местах размещения.

alt_snapshot_folder

nvarchar(255)

Указывает местоположение альтернативной папки для моментального снимка.

pre_snapshot_script

nvarchar(255)

Определяет указатель на sql-файл, который агент слияния выполняет до запуска каких-либо сценариев реплицируемых объектов при применении моментального снимка к подписчику.

post_snapshot_script

nvarchar(255)

Определяет указатель на sql-файл, который агент слияния выполняет после применения всех других сценариев и данных реплицируемых объектов во время начальной синхронизации.

compress_snapshot

bit

Указывает, что моментальный снимок, записываемый в папку alt_snapshot_folder, сжат в архив формата Microsoft CAB.

ftp_address

sysname

Сетевой адрес службы FTP для распространителя. Указывает расположение файлов моментальных снимков публикации, которые требуются агенту слияния.

ftp_port

int

Номер порта службы FTP для распространителя. Аргумент ftp_port имеет по умолчанию значение 21. Указывает расположение файлов моментальных снимков публикации, которые требуются агенту слияния.

ftp_subdirectory

nvarchar(255)

Указывает расположение файлов моментальных снимков, которые требуются агенту слияния, если моментальный снимок доставляется при помощи FTP.

ftp_login

sysname

Имя пользователя, используемое для подключения к службе FTP.

conflict_retention

int

Указывает срок хранения (в сутках), в течение которого хранятся конфликтующие записи. По истечении этого срока конфликтующая строка удаляется из таблицы конфликтов.

keep_partition_changes

int

Указывает, осуществляется ли оптимизация синхронизации для этой публикации. Аргумент keep_partition_changes по умолчанию имеет значение 0.

0 означает, что синхронизация не оптимизирована и отправленные всем подписчикам секции проверяются при изменении в них данных;

1 означает, что синхронизация оптимизирована и влиянию подвергаются только подписчики, имеющие строки в измененной секции.

Примечание.

Публикации слиянием используют по умолчанию предварительно вычисляемые секции, что обеспечивает более высокую степень оптимизации по сравнению с данным аргументом. Дополнительные сведения см. в разделах Параметризованные фильтры строк и Оптимизация производительности параметризованного фильтра с помощью предварительно вычисляемых секций.

allow_subscription_copy

int

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

allow_synctoalternate

int

Указывает, разрешена ли синхронизация альтернативного участника синхронизации с данным издателем. 0 указывает, что участник синхронизации не разрешен.

validate_subscriber_info

nvarchar(500)

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

backward_comp_level

int

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

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_activedirectory

bit

Указывает, опубликованы ли сведения о публикации в службе каталогов Microsoft Active Directory. 0 означает, что сведения о публикации не доступны из службы каталогов Active Directory.

Этот аргумент является устаревшим и поддерживается только для обратной совместимости. Больше нельзя добавлять данные публикации в службу Microsoft Active Directory.

max_concurrent_merge

int

Число параллельных процессов слияния. 0 означает, что ограничение на число одновременно выполняющихся процессов слияния отсутствует.

max_concurrent_dynamic_snapshots

int

Максимальное количество параллельных сеансов моментальных снимков фильтрованных данных, которые могут выполняться для публикации слиянием. Если это значение равно 0, то ограничение на максимальное число параллельных сеансов моментальных снимков фильтрованных данных, одновременно выполняемых для публикации в любое заданное время, отсутствует.

use_partition_groups

int

Указывает, используются ли предварительно вычисляемые секции. 1 означает, что предварительно вычисляемые секции используются.

num_of_articles

int

Количество статей в публикации.

replicate_ddl

int

Указывает, реплицируются ли изменения схемы для опубликованных таблиц. 1 означает, что изменения схемы реплицируются.

publication_number

smallint

Номер, присвоенный этой публикации.

allow_subscriber_initiated_snapshot

bit

Указывает, могут ли подписчики инициировать процесс формирования моментальных снимков фильтрованных данных. 1 означает, что подписчики могут инициировать процесс формирования моментальных снимков.

allow_web_synchronization

bit

Указывает, разрешена ли публикация для веб-синхронизации. 1 означает, что веб-синхронизация разрешена.

web_synchronization_url

nvarchar(500)

Идентификатор URL-адреса Интернета, используемый для веб-синхронизации.

allow_partition_realignment

bit

Указывает, отсылаются ли удаления на подписчик, когда изменение строки на издателе приводит к изменению секции.

1 означает, что удаления отсылаются на подписчик.

0 означает, что удаления не отсылаются. Дополнительные сведения см. в разделе sp_addmergepublication

retention_period_unit

tinyint

Определяет единицу, используемую для указания срока хранения, которая может принимать одно из следующих значений:

0 = сутки;

1 = неделя;

2 = месяц;

3 = год.

has_downloadonly_articles

bit

Указывает, являются ли какие-либо из статей публикации статьями, предназначенными только для загрузки. 1 означает, что в публикации есть статьи, предназначенные только для загрузки.

decentralized_conflicts

int

Указывает, сохранены ли на подписчике записи, вызвавшие конфликтную ситуацию:

0 = конфликтующие записи не сохранены на подписчике;

1 = конфликтующие записи сохранены на подписчике.

generation_leveling_threshold

int

Задает число изменений в формировании. Формирование — это набор изменений, передаваемых издателю или подписчику. Дополнительные сведения см. в разделе Как репликация слиянием отслеживает и перечисляет изменения.

automatic_reinitialization_policy

bit

Указывает, загружаются ли с подписчика изменения до проведения автоматической повторной инициализации.

1 = изменения с подписчика загружаются.

0 = изменения с подписчика не загружаются.

Замечания

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

Разрешения

Члены списка доступа к публикации могут выполнять для нее процедуру sp_helpmergepublication. Члены фиксированной роли базы данных db_owner в базе данных публикации могут выполнять процедуру sp_helpmergepublication для получения сведений обо всех публикациях.

Пример

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks]
EXEC sp_helpmergepublication @publication = @publication;
GO

См. также

Справочник

sp_addmergepublication (Transact-SQL)
sp_changemergepublication (Transact-SQL)
sp_dropmergepublication (Transact-SQL)
Хранимые процедуры репликации (Transact-SQL)

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

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

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

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

Журнал изменений

Версия	Журнал
12 декабря 2006 г.	Новое содержимое Добавлены сведения о столбце generation_leveling_threshold.