Condividi tramite

  • Articolo

sp_change_log_shipping_primary_database (Transact-SQL)

Modifica le impostazioni del database primario.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory'] 
[, [ @backup_share = ] '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 è di tipo sysname e non prevede alcun valore predefinito.

  • [ @backup_directory = ] 'backup_directory'
    Percorso della cartella di backup nel server primario. backup_directory è di tipo nvarchar(500), non prevede alcun valore predefinito e non può essere NULL.

  • [ @backup_share = ] 'backup_share'
    Percorso di rete della directory di backup nel server primario. backup_share è di tipo nvarchar(500), non prevede alcun valore predefinito e non può essere NULL.

  • [ @backup_retention_period = ] 'backup_retention_period'
    Periodo di tempo, in minuti, per cui il file di backup del log deve essere mantenuto nella directory di backup nel server primario. backup_retention_period è di tipo int, non prevede alcun valore predefinito 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 è di tipo bit e non può essere 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, in minuti, trascorso dall'ultimo backup prima che venga generato un errore threshold_alert. backup_threshold è di tipo int e il valore predefinito è 60 minuti.

  • [ @threshold_alert = ] 'threshold_alert'
    Avviso da generare quando viene superata la soglia di backup. threshold_alert è di tipo int e non può essere NULL.

  • [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
    Specifica se allo scadere del tempo immesso in backup_threshold verrà generato un avviso.

    1 = Abilitato.

    0 = Disabilitato.

    threshold_alert_enabled è di tipo bit e non può essere NULL.

  • [ @history_retention_period = ] 'history_retention_period'
    Periodo di memorizzazione della cronologia espresso in minuti. history_retention_period è di tipo int. Se non si specifica un valore, verrà 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 solo in SQL Server 2008 Enterprise Edition o versione successiva.

    0 = disabilitata. I backup del log non vengono mai compressi.

    1 = abilitata. I backup del log vengono sempre compressi.

    2= viene utilizzata l'opzione di configurazione del server backup compression default. Si tratta del valore predefinito.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

La stored procedure sp_change_log_shipping_primary_database deve essere eseguita nel database master nel server primario. Questa stored procedure esegue le operazioni seguenti:

  1. Modifica le impostazioni del record di log_shipping_secondary_database, se necessario.

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

  3. Se il server di monitoraggio è diverso dal server primario, modifica il record in log_shipping_monitor_primary nel server di monitoraggio utilizzando gli argomenti specificati, se necessario.

Autorizzazioni

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

Esempi

In questo esempio viene illustrato l'utilizzo di sp_change_log_shipping_primary_database per aggiornare le impostazioni associate al database primario AdventureWorks2008R2.

EXEC master.dbo.sp_change_log_shipping_primary_database 
 @database = N'AdventureWorks2008R2' 
, @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