Condividi tramite

sp_change_log_shipping_primary_database (Transact-SQL)

Si applica a:SQL Server

Modifica le impostazioni del database primario.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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>;[...]' ]
[ ; ]

Argomenti

[ @database = ] 'database'

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

[ @backup_directory = ] N'backup_directory'

Percorso della cartella di backup nel server primario. @backup_directory è nvarchar(500), senza impostazione predefinita e non può essere NULL.

[ @backup_share = ] N'backup_share'

Percorso di rete della directory di backup nel server primario. @backup_share è nvarchar(500), senza impostazione predefinita e non può essere NULL.

[ @backup_retention_period = ] 'backup_retention_period'

Periodo di tempo, espresso in minuti, per conservare il file di backup del log nella directory di backup nel server primario. @backup_retention_period è int, senza impostazione predefinita e non può essere NULL.

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

[ @backup_threshold = ] 'backup_threshold'

Periodo di tempo, espresso in minuti, dopo l'ultimo backup prima che venga generato un errore di @threshold_alert . @backup_threshold è int, con un valore predefinito di 60 minuti.

[ @threshold_alert = ] 'threshold_alert'

Avviso da generare quando viene superata la soglia per il backup. @threshold_alert è int e non può essere NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

Specifica se viene generato un avviso quando viene superato @backup_threshold .

  • 1:Abilitato
  • 0:disabile

threshold_alert_enabled è bit e non può essere NULL.

[ @history_retention_period = ] 'history_retention_period'

Periodo di tempo in minuti in cui viene mantenuta la cronologia. @history_retention_period è int. Se non viene specificato alcun valore, viene utilizzato il valore 14420.

[ @backup_compression = ] backup_compression_option

Specifica se una configurazione per il log shipping utilizza la compressione dei backup. Questo parametro è supportato in Enterprise Edition per SQL Server 2008 (10.0.x) (e versioni successive) e in tutte le edizioni in SQL Server 2016 (13.x) con Service Pack 1 (e versioni successive).

  • 0:Disabile. Non comprimere mai i backup del log

  • 1:Abilitato. Comprimere sempre i backup del log

  • 2 (impostazione predefinita): usare l'opzione di configurazione del server backup compression default .

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

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

Specifica opzioni di connettività aggiuntive 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_primary_database deve essere eseguito dal master database nel server primario. Questa stored procedure esegue le operazioni seguenti:

  1. Modifica le impostazioni nel log_shipping_primary_database record, se necessario.

  2. Modifica il record locale in log_shipping_monitor_primary nel server primario utilizzando argomenti forniti, se necessario.

  3. Se il server di monitoraggio è diverso dal server primario, cambia record nel log_shipping_monitor_primary server di monitoraggio utilizzando argomenti forniti, se necessario.

Autorizzazioni

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

Esempi

In questo esempio viene illustrato l'uso di sp_change_log_shipping_primary_database per aggiornare le impostazioni associate al database AdventureWorks2025primario.

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;

Contenuto correlato

  • Last updated on