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

sp_add_log_shipping_primary_database (Transact-SQL)

A következőkre vonatkozik:SQL Server

Beállítja az elsődleges adatbázist egy naplószállítási konfigurációhoz, beleértve a biztonsági mentési feladatot, a helyi monitorozási rekordot és a távoli monitorozási rekordot.

Transact-SQL szintaxis konvenciók

Szemantika

sp_add_log_shipping_primary_database
    [ @database = ] 'database'
    , [ @backup_directory = ] N'backup_directory'
    , [ @backup_share = ] N'backup_share'
    , [ @backup_job_name = ] 'backup_job_name'
    [ , [ @backup_retention_period = ] backup_retention_period ]
    [ , [ @monitor_server = ] 'monitor_server' ]
    [ , [ @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_job_id = ] backup_job_id OUTPUT ]
    [ , [ @primary_id = ] primary_id OUTPUT ]
    [ , [ @backup_compression = ] backup_compression_option ]
    [ , [ @primary_connection_options = ] '<key_value_pairs>;[...]' ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Érvek

[ @database = ] 'adatbázis'

A napló szállítási elsődleges adatbázisának neve. @databasea sysname, alapértelmezés nélkül, és nem lehet NULL.

[ @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_job_name = ] 'backup_job_name'

A biztonsági mentést a biztonsági mentési mappába másoló elsődleges kiszolgálón található SQL Server Agent-feladat neve. @backup_job_namesysname , é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 = ] 'monitor_server'

A figyelőkiszolgáló neve. @monitor_servera sysname, alapértelmezés nélkül, é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, alapértelmezett értéke 1, és nem lehet 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, alapértelmezett értéke 14 420.

[ @threshold_alert_enabled = ] threshold_alert_enabled

Megadja, hogy a rendszer riasztást generál-e @backup_threshold túllépésekor. Az alapértelmezett nulla (0) érték azt jelenti, hogy a riasztás le van tiltva, és nem lesz aktiválva. @threshold_alert_enabledkicsit.

[ @history_retention_period = ] history_retention_period

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

[ @backup_job_id = ] backup_job_id KIMENET

Az elsődleges kiszolgálón a biztonsági mentési feladathoz társított SQL Server-ügynök feladatazonosítója. @backup_job_id egy egyedi azonosító típusú KIMENETI paraméter, és nem lehet NULL.

[ @primary_id = ] primary_id KIMENET

A naplókonfiguráció elsődleges adatbázisának azonosítója. @primary_id egy egyedi azonosító típusú KIMENETI paraméter, és nem lehet NULL.

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

  • 0:Fogyatékos. Soha ne tömörítse a naplók biztonsági mentéseit.
  • 1:Engedélyezve. Mindig tömörítse a naplók biztonsági mentéseit.
  • 2 (alapértelmezett): Használja a biztonsági mentés tömörítésének alapértelmezett kiszolgálókonfigurációs beállítását.

[ @primary_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 az elsődlegeshez való csatlakozáskor kulcsértékpárok formájában. @primary_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 Érték
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.

[ @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 Érték
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_add_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ő funkciókat hajtja végre:

  1. Létrehoz egy elsődleges azonosítót, és hozzáad egy bejegyzést a táblában log_shipping_primary_databases lévő elsődleges adatbázishoz a megadott argumentumok használatával.

  2. Létrehoz egy biztonsági mentési feladatot a letiltott elsődleges adatbázishoz.

  3. Beállítja a biztonsági mentési feladat azonosítóját a log_shipping_primary_databases bejegyzésben a biztonsági mentési feladat feladatazonosítójára.

  4. A megadott argumentumok használatával hozzáad egy helyi figyelőrekordot az elsődleges kiszolgáló táblájában log_shipping_monitor_primary .

  5. Ha a figyelőkiszolgáló eltér az elsődleges kiszolgálótól, sp_add_log_shipping_primary_database a megadott argumentumok használatával hozzáad egy figyelőrekordot log_shipping_monitor_primary a figyelőkiszolgálóhoz.

Engedélyek

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

Példák

A. Elsődleges adatbázis hozzáadása egy naplószállítási konfigurációban

Ez a példa az adatbázist AdventureWorks2025 adja hozzá elsődleges adatbázisként egy naplószállítási konfigurációban.

DECLARE @LS_BackupJobId AS UNIQUEIDENTIFIER;
DECLARE @LS_PrimaryId AS UNIQUEIDENTIFIER;

EXECUTE master.dbo.sp_add_log_shipping_primary_database
    @database = N'AdventureWorks',
    @backup_directory = N'c:\lsbackup',
    @backup_share = N'\\backupshare\lsbackup',
    @backup_job_name = N'LSBackup_AdventureWorks',
    @backup_retention_period = 1440,
    @monitor_server = N'monitor-server',
    @monitor_server_security_mode = 1,
    @backup_threshold = 60,
    @threshold_alert = 0,
    @threshold_alert_enabled = 0,
    @history_retention_period = 1440,
    @backup_job_id = @LS_BackupJobId OUTPUT,
    @primary_id = @LS_PrimaryId OUTPUT,
    @overwrite = 1,
    @backup_compression = 0;
GO

B. Elsődleges adatbázis hozzáadása szigorú titkosítással

Ez a példa hozzáadja az adatbázist AdventureWorks2025 elsődleges adatbázisként egy naplószállítási konfigurációban, és utasítja a naplószállítást, hogy használja a szigorú titkosítási beállításokat mind az elsődleges példányhoz való kapcsolódáshoz a naplószállítás végrehajtható példányától, mind az elsődleges példánytól a távoli figyelőpéldányig monitor-server.

DECLARE @LS_BackupJobId AS UNIQUEIDENTIFIER;
DECLARE @LS_PrimaryId AS UNIQUEIDENTIFIER;

EXECUTE master.dbo.sp_add_log_shipping_primary_database
    @database = N'AdventureWorks',
    @backup_directory = N'c:\lsbackup',
    @backup_share = N'\\backupshare\lsbackup',
    @backup_job_name = N'LSBackup_AdventureWorks',
    @backup_retention_period = 1440,
    @monitor_server = N'monitor-server',
    @monitor_server_security_mode = 1,
    @backup_threshold = 60,
    @threshold_alert = 0,
    @threshold_alert_enabled = 0,
    @history_retention_period = 1440,
    @backup_job_id = @LS_BackupJobId OUTPUT,
    @primary_id = @LS_PrimaryId OUTPUT,
    @overwrite = 1,
    @backup_compression = 0,
    @primary_connection_options = N'Encrypt=Strict;',
    @monitor_connection_options = N'Encrypt=Strict;';
GO

C. Használj távoli monitort kapcsolódási lehetőségekkel

A naplók szállításának figyelése megszakadhat, ha a figyelő egy távoli SQL Server 2025-példány (17.x), ha a naplószállítási topológiában lévő más SQL Server-példányok egy korábbi verziót használnak.

Miután eltávolítottad a meglévő konfigurációt, használd a következő példaszkripttel, hogy a napló szállítási konfigurációját a megfelelő @monitor_connection_options segítségével hozd létre a megfelelő konfigurációt mind a fő, mind a másodlagos replikák esetében.

DECLARE @LS_BackupJobId AS UNIQUEIDENTIFIER;
DECLARE @LS_PrimaryId AS UNIQUEIDENTIFIER;

EXECUTE
    master.dbo.sp_add_log_shipping_primary_database
    @database = N'LogShippedDB',
    @backup_directory = N'\\backupshare\lsbackup',
    @backup_share = N'\\backupshare\lsbackup',
    @backup_job_name = N'LSBackup_AdventureWorks',
    @backup_retention_period = 4320,
    @backup_compression = 2,
    @monitor_server = N'LS25Monitor',
    @monitor_server_security_mode = 1,
    @backup_threshold = 60,
    @threshold_alert_enabled = 1,
    @history_retention_period = 5760,
    @backup_job_id = @LS_BackupJobId OUTPUT,
    @primary_id = @LS_PrimaryId OUTPUT,
    @overwrite = 1,
    @monitor_connection_options = N'Encrypt=Mandatory;TrustServerCertificate=Yes;';

További információ: Titkosítás és tanúsítványérvényesítési viselkedés.

Kapcsolódó tartalom

  • Last updated on