Condividi tramite


sp_change_log_shipping_secondary_primary (Transact-SQL)

Si applica a:SQL Server

Modifica le impostazioni del database secondario.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_change_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' ]
    [ , [ @file_retention_period = ] file_retention_period ]
    [ , [ @monitor_server_security_mode = ] monitor_server_security_mode ]
    [ , [ @monitor_server_login = ] 'monitor_server_login' ]
    [ , [ @monitor_server_password = ] 'monitor_server_password' ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argomenti

[ @primary_server = ] 'primary_server'

Nome dell'istanza primaria del Motore di database di SQL Server nella configurazione di log shipping. @primary_server è sysname e non può essere NULL.

[ @primary_database = ] 'primary_database'

Nome del database nel server primario. @primary_database è sysname, senza impostazione predefinita.

[ @backup_source_directory = ] N'backup_source_directory'

Directory in cui vengono archiviati i file di backup del log delle transazioni dal server primario. @backup_source_directory è nvarchar(500) e non può essere NULL.

[ @backup_destination_directory = ] N'backup_destination_directory'

Directory nel server secondario in cui vengono copiati i file di backup. @backup_destination_directory è nvarchar(500) e non può essere NULL.

[ @file_retention_period = ] 'file_retention_period'

Periodo di tempo in minuti in cui vengono conservati i file di backup. @file_retention_period è int, con il valore predefinito NULL. Se non si specifica un valore, verrà utilizzato il valore 14420.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

Modalità di sicurezza utilizzata per connettersi al server di monitoraggio.

  • 1: autenticazione di Windows;
  • 0: autenticazione di SQL Server.

@monitor_server_security_mode è bit e il valore predefinito è NULL.

[ @monitor_server_login = ] 'monitor_server_login'

Nome utente dell'account utilizzato per accedere al server di monitoraggio.

[ @monitor_server_password = ] 'monitor_server_password'

Password dell'account utilizzato per accedere al server di monitoraggio.

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

Si applica a: SQL Server 2025 (17.x) e versioni successive

Specifica altre opzioni di connettività per la connessione al server collegato quando si utilizza un monitoraggio remoto, sotto forma di coppie chiave-valore. @monitor_connection_options è nvarchar(4000) e ha il valore predefinito .NULL

Nella tabella seguente sono elencate le opzioni di connettività disponibili:

Key Value
Encrypt strict, mandatory, optional, truefalse
TrustServerCertificate true, false, yesno
ServerCertificate Percorso nel file system del certificato del server. Lunghezza massima di 260 caratteri.
HostNameInCertificate Override del nome host per il certificato. Lunghezza massima di 255 caratteri.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Nessuno.

Osservazioni:

sp_change_log_shipping_secondary_primary deve essere eseguito dal master database nel server secondario. Questa stored procedure esegue le azioni seguenti:

  1. Modifica le impostazioni in secondo log_shipping_secondary necessità.

  2. Se il server di monitoraggio è diverso dal server secondario, modifica il record di monitoraggio nel log_shipping_monitor_secondary server di monitoraggio utilizzando argomenti forniti, se necessario.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire questa procedura.