sp_replicationdboption (Transact-SQL)

Мақала
07/05/2024

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

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

Соглашения о синтаксисе 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 и может быть одним из этих значений.

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

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

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

[ @from_scripting = ] from_scripting

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

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

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

Замечания

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

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

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

Разрешения

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

См. также

Настройка публикации и распространения
Create a Publication
Delete a Publication (Удаление публикации)
Отключение публикации и распространения
sys.databases (Transact-SQL)
Хранимые процедуры репликации (Transact-SQL)

Бөлісу құралы: