sp_replicationdboption (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

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

Синтаксис

sp_replicationdboption
    [ @dbname = ] N'dbname'
    , [ @optname = ] N'optname'
    , [ @value = ] { N'true' | N 'false' }
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]
[ ; ]

Аргументы

[ @dbname = ] N'dbname'

База данных, для которой устанавливается параметр базы данных репликации. @dbname — sysname, без значения по умолчанию.

[ @optname = ] N'optname'

Параметр базы данных репликации для включения или отключения. @optname является sysname и может быть одним из этих значений.

значение Описание
merge publish База данных может использоваться для публикации слиянием.
publish База данных может использоваться для других типов публикаций.
subscribe База данных является базой данных подписки.
sync with backup База данных доступна для скоординированного создания резервных копий. Дополнительные сведения см. в разделе "Включение координированных резервных копий для репликации транзакций".

[ @value = ] { N'true' | N 'false' }

Включение или отключение заданного параметра базы данных репликации. @value — sysname, без значения по умолчанию. Если это значение и false @optnamemerge publish, подписки на опубликованную базу данных слияния также удаляются.

[ @ignore_distributor = ] ignore_distributor

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

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

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

[ @from_scripting = ] from_scripting

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

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

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

Замечания

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

Эта процедура создает или удаляет определенные системные таблицы репликации, учетные записи безопасности и так далее в зависимости от указанного аргумента. Задает соответствующую is_published (репликацию транзакций или моментальных снимков), is_merge_published (репликацию слиянием) или is_distributor биты в системной master.databases таблице и создает необходимые системные таблицы.

Для отключения публикации база данных публикации должна находиться в режиме «в сети». Если для базы данных публикации существует моментальный снимок, он должен быть удален перед отключением публикации. Моментальный снимок базы данных — это автономная копия базы данных только для чтения и не связана с моментальным снимком репликации. Дополнительные сведения см. в разделе "Моментальные снимки базы данных" (SQL Server).

Разрешения

Могут выполняться sp_replicationdboptionтолько члены предопределенных ролей сервера sysadmin.