Sdílet prostřednictvím

sp_add_log_shipping_secondary_primary (Transact-SQL)

platí pro:SQL Server

Nastaví primární informace, přidá odkazy místního a vzdáleného monitorování a vytvoří úlohy kopírování a obnovení na sekundárním serveru pro zadanou primární databázi.

Transact-SQL konvence syntaxe

Syntaxe

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'

Název primární instance databázového stroje SQL Serveru v konfiguraci přesouvání protokolů. @primary_server je sysname a nemůže být NULL.

[ @primary_database = ] 'primary_database'

Název databáze na primárním serveru. @primary_database je sysname bez výchozího nastavení.

[ @backup_source_directory = ] N'backup_source_directory'

Adresář, kde jsou uloženy záložní soubory transakčního protokolu z primárního serveru. @backup_source_directory je nvarchar(500) a nemůže být NULL.

[ @backup_destination_directory = ] N'backup_destination_directory'

Adresář na sekundárním serveru, do kterého se zkopírují záložní soubory. @backup_destination_directory je nvarchar(500) a nemůže být NULL.

[ @copy_job_name = ] 'copy_job_name'

Název, který se má použít pro úlohu agenta SQL Serveru, která se vytváří ke kopírování záloh transakčních protokolů na sekundární server. copy_job_name je sysname a nemůže být NULL.

[ @restore_job_name = ] 'restore_job_name'

Název úlohy agenta SQL Serveru na sekundárním serveru, který obnoví zálohy do sekundární databáze. restore_job_name je sysname a nemůže být NULL.

[ @file_retention_period = ] 'file_retention_period'

Doba v minutách, po kterou je záložní soubor zachován na sekundárním serveru v cestě určené parametrem před odstraněním @backup_destination_directory . @history_retention_period je int, s výchozí hodnotou NULL. Pokud není zadána žádná hodnota 14420, použije se hodnota 14420.

[ @monitor_server = ] 'monitor_server'

Název serveru monitorování. @monitor_server je sysname, bez výchozího nastavení a nemůže být NULL.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

Režim zabezpečení používaný pro připojení k serveru monitorování.

  • 1: Ověřování systému Windows
  • 0: Ověřování SQL Serveru

@monitor_server_security_mode je bit s výchozím nastavením 1a nemůže být NULL.

[ @monitor_server_login = ] 'monitor_server_login'

Uživatelské jméno účtu použitého pro přístup k serveru monitorování.

[ @monitor_server_password = ] 'monitor_server_password'

Heslo účtu použitého pro přístup k serveru monitorování.

[ @copy_job_id = ] VÝSTUP 'copy_job_id'

ID přidružené k úloze kopírování na sekundárním serveru. @copy_job_id je uniqueidentifier a nemůže být NULL.

[ @restore_job_id = ] VÝSTUP 'restore_job_id'

ID přidružené k úloze obnovení na sekundárním serveru. @restore_job_id je uniqueidentifier a nemůže být NULL.

[ @secondary_id = ] 'secondary_id' VÝSTUP

ID sekundárního serveru v konfiguraci odeslání protokolu. @secondary_id je uniqueidentifier a nemůže být NULL.

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

Platí na: SQL Server 2025 (17.x) a novější verze

Určuje další možnosti připojení při připojování k sekundární hodnotě ve formě párů klíč-hodnota. @secondary_connection_options je nvarchar(4000) a má výchozí hodnotu NULL.

V následující tabulce jsou uvedené dostupné možnosti připojení:

Key Hodnota
Encrypt strict, mandatory, optional, , truefalse
TrustServerCertificate true, false, , yesno
ServerCertificate Cesta v systému souborů k certifikátu serveru. Má maximální délku 260 znaků.
HostNameInCertificate Přepsání názvu hostitele pro certifikát Má maximální délku 255 znaků.

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

Platí na: SQL Server 2025 (17.x) a novější verze

Určuje další možnosti připojení pro připojení k propojenému serveru při použití vzdáleného monitoru ve formě párů klíč-hodnota. @monitor_connection_options je nvarchar(4000) a má výchozí hodnotu NULL.

V následující tabulce jsou uvedené dostupné možnosti připojení:

Key Hodnota
Encrypt strict, mandatory, optional, , truefalse
TrustServerCertificate true, false, , yesno
ServerCertificate Cesta v systému souborů k certifikátu serveru. Má maximální délku 260 znaků.
HostNameInCertificate Přepsání názvu hostitele pro certifikát Má maximální délku 255 znaků.

Návratové hodnoty kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Žádné.

Poznámky

sp_add_log_shipping_secondary_primary musí být spuštěna master z databáze na sekundárním serveru. Tato uložená procedura provede následující akce:

  1. Vygeneruje sekundární ID pro zadaný primární server a primární databázi.

  2. Provede následující:

    1. Přidá položku pro sekundární ID log_shipping_secondary pomocí zadaných argumentů.
    2. Vytvoří úlohu kopírování pro sekundární ID, které je zakázané.
    3. Nastaví ID úlohy kopírování v log_shipping_secondary položce na ID úlohy kopírování.
    4. Vytvoří úlohu obnovení pro sekundární ID, které je zakázané.
    5. Nastavte ID úlohy obnovení v log_shipping_secondary položce na ID úlohy obnovení.

Povolení

Tento postup můžou spustit pouze členové pevné role serveru sysadmin .

Examples

Tento příklad ukazuje použití sp_add_log_shipping_secondary_primary uložené procedury k nastavení informací pro primární databázi AdventureWorks2025 na sekundárním serveru.

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

Související obsah

  • Last updated on