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

sys.sp_change_log_shipping_primary_database
    [ @database = ] N'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 = ] N'monitor_server_login' ]
    [ , [ @monitor_server_password = ] N'monitor_server_password' ]
    [ , [ @backup_threshold = ] backup_threshold ]
    [ , [ @threshold_alert = ] threshold_alert ]
    [ , [ @threshold_alert_enabled = ] threshold_alert_enabled ]
    [ , [ @history_retention_period = ] history_retention_period ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
    [ , [ @backup_compression = ] backup_compression ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argomenti

[ @database = ] N'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 = ] N'monitor_server_login'

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

[ @monitor_server_password = ] N'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è un po' 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.

[ @ignoreremotemonitor = ] ignoramonitormonitoreremoto

Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.

[ @backup_compression = ] backup_compression

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