sys.sp_change_log_shipping_primary_database (Transact-SQL)

Область применения:SQL Server

Изменяет настройки базы данных-источника.

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

Синтаксис

sys.sp_change_log_shipping_primary_database
    [ @database = ] N'database'
    [ , [ @backup_directory = ] N'backup_directory' ]
    [ , [ @backup_share = ] N'backup_share' ]
    [ , [ @backup_retention_period = ] backup_retention_period ]
    [ , [ @monitor_server_security_mode = ] monitor_server_security_mode ]
    [ , [ @monitor_server_login = ] N'monitor_server_login' ]
    [ , [ @monitor_server_password = ] N'monitor_server_password' ]
    [ , [ @backup_threshold = ] backup_threshold ]
    [ , [ @threshold_alert = ] threshold_alert ]
    [ , [ @threshold_alert_enabled = ] threshold_alert_enabled ]
    [ , [ @history_retention_period = ] history_retention_period ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
    [ , [ @backup_compression = ] backup_compression ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Аргументы

[ @database = ] N'database'

Имя базы данных на сервере-источнике. @primary_database — sysname без значения по умолчанию.

[ @backup_directory = ] N'backup_directory'

Путь к папке резервного копирования на основном сервере. @backup_directory является nvarchar(500), без значения по умолчанию и не может бытьNULL.

[ @backup_share = ] N'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 бит и по умолчанию используется NULL.

[ @monitor_server_login = ] N'monitor_server_login'

Имя пользователя учетной записи, используемой для доступа к серверу мониторинга.

[ @monitor_server_password = ] N'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бит и не может быть NULL.

[ @history_retention_period = ] history_retention_period

Длительность времени в минутах, в течение которого сохраняется журнал. @history_retention_period является int. Значение 14420 используется, если нет.

[ @ignoreremotemonitor = ] игнорировать дистанционный монитор

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

[ @backup_compression = ] backup_compression

Указывает, используется ли конфигурация доставки журналов сжатие резервных копий. Этот параметр поддерживается в выпуске Enterprise для SQL Server 2008 (10.0.x) (и более поздних версий), а также во всех выпусках SQL Server 2016 (13.x) с пакетом обновления 1 (и более поздних версиях).

  • 0:Нетрудоспособный. Никогда не сжимать резервные копии журналов

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

  • 2 (по умолчанию): используйте параметр конфигурации сервера сжатия резервных копий по умолчанию .

[ @monitor_connection_options = ] '<key_value_pairs>;[ ...]'

Применимо к: SQL Server 2025 (17.x) и более поздним версиям

Задает дополнительные параметры подключения для подключения связанного сервера при использовании удаленного монитора в виде пар "значение ключа". @monitor_connection_options — nvarchar(4000) и имеет значение по умолчанию NULL.

В следующей таблице перечислены доступные параметры подключения:

Key Value
Encrypt strict, , mandatoryoptional, truefalse
TrustServerCertificate true false yes no
ServerCertificate Путь к файловой системе к сертификату сервера. Это имеет максимальную длину 260 символов.
HostNameInCertificate Переопределение имени узла для сертификата. Это имеет максимальную длину 255 символов.

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

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 для обновления параметров, связанных с базой данных-источником AdventureWorks2025.

EXECUTE 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,
    @backup_compression = 1;

Связанный контент

  • Последнее обновление: