sp_replicationdboption (Transact-SQL)

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

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_replicationdboption [ @dbname= ] 'db_name' 
        , [ @optname= ] 'optname' 
        , [ @value= ] 'value' 
    [ , [ @ignore_distributor= ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]

Аргументы

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

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

    Значение

    Описание

    merge publish

    База данных может использоваться для публикации слиянием.

    publish

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

    subscribe

    База данных является базой данных подписки.

    sync with backup

    База данных доступна для скоординированного резервного копирования. Дополнительные сведения см. в разделе Как включить скоординированное создание резервных копий для репликации транзакций (программирование репликации на языке Transact-SQL).

  • [ @value=] 'value'
    Указывает, включить или выключить данный параметр репликации базы данных. Аргумент value имеет тип sysname и может принимать значение true или false. Если это значение равно false, а аргумент optname имеет значение merge publish, удаляются также подписки к базе данных, опубликованной слиянием.

  • [ @ignore_distributor=] ignore_distributor
    Указывает, выполняется ли данная хранимая процедура без подключения к распространителю. Аргумент ignore_distributor имеет тип bit и значение по умолчанию 0. Это означает, что распространитель должен быть подключен и обновлен до последнего состояния публикуемой базы данных. Значение 1 должно указываться, только если распространитель недоступен и процедура sp_replicationdboption используется для отключения публикации.

  • [ @from_scripting=] from_scripting
    Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

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

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

Замечания

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

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

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

Разрешения

Только члены предопределенной роли сервера sysadmin могут выполнять процедуру sp_replicationdboption.