Megosztás a következőn keresztül:


sp_change_log_shipping_primary_database (Transact-SQL)

A következőkre vonatkozik:SQL Server

Módosítja az elsődleges adatbázis beállításait.

Transact-SQL szintaxis konvenciók

Szemantika

sp_change_log_shipping_primary_database
    [ @database = ] '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 = ] '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 ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Érvek

[ @database = ] 'adatbázis'

Az elsődleges kiszolgálón található adatbázis neve. @primary_databasea sysname, alapértelmezés nélkül.

[ @backup_directory = ] N'backup_directory'

Az elsődleges kiszolgálón található biztonsági mentési mappa elérési útja. @backup_directorynvarchar(500), alapértelmezés nélkül, és nem lehet NULL.

[ @backup_share = ] N'backup_share'

Az elsődleges kiszolgálón található biztonsági mentési könyvtár hálózati elérési útja. @backup_sharenvarchar(500), alapértelmezés nélkül, és nem lehet NULL.

[ @backup_retention_period = ] 'backup_retention_period'

A napló biztonsági mentési fájljának az elsődleges kiszolgálón található biztonsági mentési könyvtárban való megőrzésének időtartama percekben. @backup_retention_periodint, nincs alapértelmezett, és nem lehet NULL.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

A figyelőkiszolgálóhoz való csatlakozáshoz használt biztonsági mód.

  • 1 = Windows-hitelesítés
  • 0 = SQL Server-hitelesítés

@monitor_server_security_modebit és alapértelmezett érték.NULL

[ @monitor_server_login = ] 'monitor_server_login'

A figyelőkiszolgáló eléréséhez használt fiók felhasználóneve.

[ @monitor_server_password = ] 'monitor_server_password'

A figyelőkiszolgáló eléréséhez használt fiók jelszava.

[ @backup_threshold = ] 'backup_threshold'

A @threshold_alert hiba felmerülése előtti utolsó biztonsági mentés után percekben megadott időtartam. @backup_thresholdint, alapértelmezés szerint 60 perc.

[ @threshold_alert = ] 'threshold_alert'

A biztonsági mentés küszöbértékének túllépésekor aktiválandó riasztás. @threshold_alertint és nem lehet NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

Megadja, hogy a rendszer riasztást generál-e @backup_threshold túllépésekor.

  • 1:Engedélyezve
  • 0:fogyatékos

threshold_alert_enabledbit , és nem lehet NULL.

[ @history_retention_period = ] 'history_retention_period'

Az előzmények megőrzésének időtartama percekben. @history_retention_periodint. A rendszer 14420 értéket használ, ha nincs megadva.

[ @backup_compression = ] backup_compression_option

Megadja, hogy a naplószállítási konfiguráció biztonsági mentési tömörítést használ-e. Ez a paraméter az SQL Server 2008 (10.0.x) (és újabb verziók) Enterprise kiadásában, valamint az SQL Server 2016 (13.x) és a Service Pack 1 (és újabb verziók) összes kiadásában támogatott.

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

Érvényes: SQL Server 2025 (17.x) és újabb verziók

További csatlakozási lehetőségeket ad meg a csatolt kiszolgáló kapcsolatához távoli monitor használatakor kulcsértékpárok formájában. @monitor_connection_optionsnvarchar(4000) és alapértelmezett értéke NULL.

Az alábbi táblázat az elérhető csatlakozási lehetőségeket sorolja fel:

Key Value
Encrypt strict, mandatory, optional, truefalse
TrustServerCertificate true, false, yesno
ServerCertificate A fájlrendszer elérési útja a kiszolgálótanúsítványhoz. Ez legfeljebb 260 karakter hosszúságú lehet.
HostNameInCertificate A tanúsítvány állomásnév felülbírálása. Ez legfeljebb 255 karakter hosszúságú lehet.

Kódértékek visszaadása

0 (sikeres) vagy 1 (hiba).

Eredményhalmaz

Nincs.

Megjegyzések

sp_change_log_shipping_primary_database az elsődleges kiszolgálón lévő adatbázisból master kell futtatni. Ez a tárolt eljárás a következőket teszi:

  1. Szükség esetén módosítja a log_shipping_primary_database rekord beállításait.

  2. Szükség esetén módosítja a helyi rekordot log_shipping_monitor_primary az elsődleges kiszolgálón a megadott argumentumok használatával.

  3. Ha a figyelőkiszolgáló eltér az elsődleges kiszolgálótól, szükség esetén a megadott argumentumok használatával módosítja a rekordot log_shipping_monitor_primary a figyelőkiszolgálón.

Engedélyek

Ezt az eljárást csak a sysadmin rögzített kiszolgálói szerepkör tagjai futtathatják.

Példák

Ez a példa az elsődleges adatbázishoz sp_change_log_shipping_primary_databasetársított beállítások frissítésének AdventureWorks2025 használatát mutatja be.

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;