sp_replicationdboption (Transact-SQL)
Область применения: 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)