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


sp_add_log_shipping_secondary_primary (Transact-SQL)

A következőkre vonatkozik:SQL Server

Beállítja az elsődleges információkat, hozzáadja a helyi és távoli monitorozási hivatkozásokat, és létrehozza a másolási és visszaállítási feladatokat a másodlagos kiszolgálón a megadott elsődleges adatbázishoz.

Transact-SQL szintaxis konvenciók

Szemantika

sp_add_log_shipping_secondary_primary
    [ @primary_server = ] 'primary_server'
    , [ @primary_database = ] 'primary_database'
    , [ @backup_source_directory = ] N'backup_source_directory'
    , [ @backup_destination_directory = ] N'backup_destination_directory'
    , [ @copy_job_name = ] 'copy_job_name'
    , [ @restore_job_name = ] 'restore_job_name'
    [ , [ @file_retention_period = ] 'file_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' ]
    [ , [ @copy_job_id = ] 'copy_job_id' OUTPUT ]
    [ , [ @restore_job_id = ] 'restore_job_id' OUTPUT ]
    [ , [ @secondary_id = ] 'secondary_id' OUTPUT ]
    [ , [ @secondary_connection_options = ] '<key_value_pairs>;[...]' ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Arguments

[ @primary_server = ] 'primary_server'

Az SQL Server adatbázismotor elsődleges példányának neve a naplószállítási konfigurációban. @primary_serversysname , és nem lehet NULL.

[ @primary_database = ] 'primary_database'

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

[ @backup_source_directory = ] N'backup_source_directory'

Az a könyvtár, amelyben a tranzakciónapló biztonsági mentési fájljai az elsődleges kiszolgálóról vannak tárolva. @backup_source_directorynvarchar(500) és nem lehet NULL.

[ @backup_destination_directory = ] N'backup_destination_directory'

A másodlagos kiszolgáló azon könyvtára, ahová a biztonsági mentési fájlokat átmásolja a rendszer. @backup_destination_directorynvarchar(500) és nem lehet NULL.

[ @copy_job_name = ] 'copy_job_name'

A létrehozott SQL Server Agent-feladathoz a tranzakciónapló biztonsági mentéseinek másodlagos kiszolgálóra másolásához használandó név. copy_job_namesysname , és nem lehet NULL.

[ @restore_job_name = ] 'restore_job_name'

Annak az SQL Server Agent-feladatnak a neve a másodlagos kiszolgálón, amely visszaállítja a biztonsági másolatokat a másodlagos adatbázisba. restore_job_namesysname , és nem lehet NULL.

[ @file_retention_period = ] 'file_retention_period'

A biztonsági mentési fájlnak a paraméter által @backup_destination_directory megadott elérési úton való megőrzésének időtartama percek alatt. @history_retention_periodint, alapértelmezés szerint NULL. A rendszer 14420 értéket használ, ha nincs megadva.

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

[ @copy_job_id = ] 'copy_job_id' KIMENET

A másodlagos kiszolgálón a másolási feladathoz társított azonosító. @copy_job_idegyedi azonosító , és nem lehet NULL.

[ @restore_job_id = ] 'restore_job_id' KIMENET

A másodlagos kiszolgálón a visszaállítási feladathoz társított azonosító. @restore_job_idegyedi azonosító , és nem lehet NULL.

[ @secondary_id = ] 'secondary_id' KIMENET

A másodlagos kiszolgáló azonosítója a napló szállítási konfigurációjában. @secondary_idegyedi azonosító , és nem lehet NULL.

[ @secondary_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 másodlagoshoz való csatlakozáskor kulcsértékpárok formájában. @secondary_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_secondary_primary A másodlagos kiszolgálón lévő adatbázisból master kell futtatni. Ez a tárolt eljárás a következőket teszi:

  1. Létrehoz egy másodlagos azonosítót a megadott elsődleges kiszolgálóhoz és elsődleges adatbázishoz.

  2. A következőket teszi:

    1. Hozzáad egy bejegyzést a másodlagos azonosítóhoz log_shipping_secondary a megadott argumentumok használatával.
    2. Létrehoz egy másolási feladatot a letiltott másodlagos azonosítóhoz.
    3. A másolási feladat azonosítóját a log_shipping_secondary bejegyzésben a másolási feladat feladatazonosítójára állítja.
    4. Létrehoz egy visszaállítási feladatot a letiltott másodlagos azonosítóhoz.
    5. Állítsa be a visszaállítási feladat azonosítóját a log_shipping_secondary bejegyzésben a visszaállítási feladat feladatazonosítójára.

Permissions

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 azt szemlélteti, hogy a sp_add_log_shipping_secondary_primary tárolt eljárás használatával állítja be az elsődleges adatbázis AdventureWorks2025 adatait a másodlagos kiszolgálón.

EXECUTE master.dbo.sp_add_log_shipping_secondary_primary
    @primary_server = N'TRIBECA',
    @primary_database = N'AdventureWorks2022',
    @backup_source_directory = N'\\tribeca\LogShipping',
    @backup_destination_directory = N'',
    @copy_job_name = N'',
    @restore_job_name = N'',
    @file_retention_period = 1440,
    @monitor_server = N'ROCKAWAY',
    @monitor_server_security_mode = 1,
    @copy_job_id = @LS_Secondary__CopyJobId OUTPUT,
    @restore_job_id = @LS_Secondary__RestoreJobId OUTPUT,
    @secondary_id = @LS_Secondary__SecondaryId OUTPUT;
GO