sp_change_log_shipping_primary_database (Transact-SQL)
Изменяет настройки базы данных-источника.
Синтаксические обозначения в Transact-SQL
Синтаксис
sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory']
[, [ @backup_share = ] 'backup_share',
[, [ @backup_retention_period = ] 'backup_retention_period']
[, [ @monitor_server_security_mode = ] 'monitor_server_security_mode']
[, [ @monitor_server_login = ] 'monitor_server_login']
[, [ @monitor_server_password = ] 'monitor_server_password']
[, [ @backup_threshold = ] 'backup_threshold']
[, [ @threshold_alert = ] 'threshold_alert']
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled']
[, [ @history_retention_period = ] 'history_retention_period']
Аргументы
- [ @database = ] 'database'
Имя базы данных на сервере-источнике. Аргумент primary_database имеет тип sysname и не имеет значения по умолчанию.
- [ @backup_directory = ] 'backup_directory'
Путь к папке резервного копирования на сервере-источнике. Аргумент backup_directory имеет тип nvarchar(500), не имеет значения по умолчанию и не может принимать значения NULL.
- [ @backup_share = ] 'backup_share'
Сетевой путь к каталогу резервного копирования на сервере-источнике. Аргумент backup_share имеет тип nvarchar(500), не имеет значения по умолчанию и не может принимать значения NULL.
- [ @backup_retention_period = ] 'backup_retention_period'
Время в минутах, в течение которого файл резервной копии журнала хранится в каталоге резервных копий на сервере-источнике. Аргумент backup_retention_period имеет тип int, не имеет значения по умолчанию и не может принимать значение NULL.
[ @monitor_server_security_mode = ] 'monitor_server_security_mode'
Режим безопасности, используемый для подключения к серверу мониторинга.1 = проверка подлинности Windows.
0 = проверка подлинности SQL Server.
Аргумент monitor_server_security_mode имеет тип bit и не может принимать значения NULL.
- [ @monitor_server_login = ] 'monitor_server_login'
Имя учетной записи, используемой для доступа к серверу мониторинга.
- [ @monitor_server_password = ] 'monitor_server_password'
Пароль учетной записи, используемой для доступа к серверу мониторинга.
- [ @backup_threshold = ] 'backup_threshold'
Длительность времени в минутах после последнего резервного копирования и до инициации ошибки threshold_alert. Аргумент backup_threshold имеет тип int, значение которого по умолчанию равно 60 минутам.
- [ @threshold_alert = ] 'threshold_alert'
Предупреждение, выдаваемое при превышении порога резервных копий. Аргумент threshold_alert имеет тип int и не может принимать значения NULL.
[ @threshold_alert_enabled = ] 'threshold_alert_enabled'
Указывает, выдается ли предупреждение при превышении порога резервных копий backup_threshold.1 = выдается.
0 = не выдается.
Аргумент threshold_alert_enabled имеет тип bit и не может принимать значения NULL.
- [ @history_retention_period = ] 'history_retention_period'
Длительность времени в минутах, в течение которого сохраняется журнал. Аргумент history_retention_period имеет тип int. Если не задан, используется значение 14420.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Результирующие наборы
Нет
Замечания
Хранимую процедуру sp_change_log_shipping_primary_database необходимо запускать из базы данных master на сервере-источнике. Эта хранимая процедура выполняет следующее:
- В случае необходимости изменяет параметры в записи log_shipping_primary_database.
- В случае необходимости изменяет локальную запись в log_shipping_monitor_primary на сервере-источнике, используя заданные аргументы.
- В случае необходимости, если сервер мониторинга отличается от сервера-источника, изменяет запись в log_shipping_monitor_primary на сервере мониторинга, используя заданные аргументы.
Разрешения
Эту процедуру могут выполнять только члены фиксированной серверной роли sysadmin.
Примеры
Данный пример иллюстрирует использование процедуры sp_change_log_shipping_primary_database для обновления настроек, связанных с базой данных-источником AdventureWorks.
EXEC master.dbo.sp_change_log_shipping_primary_database
@database = N'AdventureWorks'
, @backup_directory = N'c:\LogShipping'
, @backup_share = N'\\tribeca\LogShipping'
, @backup_retention_period = 1440
, @backup_threshold = 60
, @threshold_alert = 0
, @threshold_alert_enabled = 1
, @history_retention_period = 1440
,@monitor_server_security_mode = 1
См. также
Справочник
Системные хранимые процедуры (Transact-SQL)
log_shipping_primary_databases (Transact-SQL)
Другие ресурсы
Доставка журналов
Таблицы доставки журналов и хранимые процедуры