• Статья

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']
[, [ @backup_compression = ] backup_compression_option ]

Аргументы

  • [ @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.

  • [ @backup_compression = ] backup_compression_option
    Указывает, используется ли backup compression в конфигурации доставки журналов. Этот параметр поддерживается только в SQL Server 2008 Enterprise (или более поздней версии).

    0 = отключено. Не сжимать резервные копии журналов.

    1 = включено. Всегда сжимать резервные копии журналов.

    2 = использовать значение параметра конфигурации сервера backup compression default. Это значение по умолчанию.

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

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

Результирующие наборы

Нет

Замечания

Хранимую процедуру sp_change_log_shipping_primary_database необходимо запускать из базы данных master на сервере-источнике. Эта хранимая процедура выполняет следующее:

  1. В случае необходимости изменяет параметры в записи log_shipping_primary_database.

  2. В случае необходимости изменяет локальную запись в log_shipping_monitor_primary на сервере-источнике, используя заданные аргументы.

  3. В случае необходимости, если сервер мониторинга отличается от сервера-источника, изменяет запись в log_shipping_monitor_primary на сервере мониторинга, используя заданные аргументы.

Разрешения

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

Примеры

Данный пример показывает использование процедуры sp_change_log_shipping_primary_database для обновления настроек, связанных с базой данных-источником База данных AdventureWorks2008R2.

EXEC master.dbo.sp_change_log_shipping_primary_database 
 @database = N'AdventureWorks2008R2' 
, @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
,@backup_compression = 1