sp_change_log_shipping_primary_database (Transact-SQL)

  • Articolo

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

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).

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 AdventureWorks2022primario.

EXEC 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