applicazione sqllogship

Si applica a:SQL Server

L'applicazione sqllogship esegue un'operazione di backup, copia o ripristino e le attività di pulizia associate a una configurazione del log shipping. L'operazione viene eseguita su un'istanza specifica di SQL Server per un database specifico.

Per le convenzioni di sintassi, vedere Utilità della riga di comando SQL (motore di database).

Sintassi

sqllogship
-server instance_name { -backup primary_id | -copy secondary_id | -restore secondary_id }
[ -verboselevel level ]
[ -logintimeout timeout_value ]
[ -querytimeout timeout_value ]
[ -connectionoptions "<key_value_pairs>; [ ... ]" ]

Argomenti

-server instance_name

Specifica l'istanza di SQL Server in cui viene eseguita l'operazione. L'istanza del server da specificare dipende dall'operazione di trasferimento dei log specificata. Per -backup, instance_name deve essere il nome del server primario in una configurazione di log shipping. Per -copy o -restore, instance_name deve essere il nome di un server secondario in una configurazione di log shipping.

-backup primary_id

Esegue un'operazione di backup per il database primario corrispondente all'ID primario specificato tramite primary_id. Potete ottenere questo ID selezionandolo dalla tabella di sistema log_shipping_primary_databases oppure utilizzando la stored procedure sp_help_log_shipping_primary_database.

L'operazione di backup crea il backup del log nella directory di backup. L'applicazione sqllogship elimina quindi tutti i file di backup meno recenti in base al periodo di conservazione dei file. La cronologia per l'operazione di backup viene poi registrata dall'applicazione nel server primario e nel server di monitoraggio. Alla fine, l'applicazione esegue sp_cleanup_log_shipping_history, che elimina le informazioni storiche vecchie in base al periodo di mantenimento.

-copy secondary_id

Esegue un'operazione di copia per copiare i backup dal server secondario specificato per il database o i database secondari, corrispondenti all'ID secondario specificato tramite secondary_id. È possibile ottenere questo ID selezionandolo dalla tabella di sistema log_shipping_secondary oppure utilizzando la stored procedure sp_help_log_shipping_secondary_database.

L'operazione copia i file di backup dalla directory di backup alla directory di destinazione. L'applicazione sqllogship registra quindi la cronologia per l'operazione di copia nel server secondario e nel server di monitoraggio.

-restore secondary_id

Esegue un'operazione di ripristino nel server secondario specificato per il database o i database secondari, corrispondenti all'ID secondario specificato tramite secondary_id. È possibile ottenere questo ID usando la sp_help_log_shipping_secondary_database stored procedure.

Tutti i file di backup nella directory di destinazione creati dopo il punto di ripristino più recente vengono ripristinati nel database o nei database secondari. L'applicazione sqllogship elimina quindi tutti i file di backup meno recenti in base al periodo di conservazione dei file. La cronologia per l'operazione di ripristino viene poi registrata dall'applicazione nel server secondario e nel server di monitoraggio. Infine, l'applicazione esegue sp_cleanup_log_shipping_history, che elimina le informazioni di cronologia precedenti, in base al periodo di conservazione.

Livello -verboselevel

Specifica il livello di messaggi aggiunti alla cronologia della spedizione dei log. level può essere uno dei valori interi seguenti:

Livello	Descrizione
0	L'output non include messaggi di traccia e di debug.
1	Emettere messaggi di gestione degli errori.
2	L'output include messaggi di avviso e di gestione degli errori.
3 (impostazione predefinita)	Visualizzare messaggi informativi, avvisi e di gestione degli errori.
4	L'output include tutti i messaggi di debug e di tracciamento.

-logintimeout timeout_value

Specifica la quantità di tempo assegnata per il tentativo di accesso all'istanza del server prima del timeout del tentativo. Il valore predefinito è 15 secondi. timeout_value è int.

-querytimeout timeout_value

Specifica la quantità di tempo assegnata per l'avvio dell'operazione specificata prima del timeout del tentativo. Per impostazione predefinita, non si ha alcun timeout impostato. timeout_value è int.

-connectionoptions "<key_value_pairs>; [ ... n ] "

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

Specifica opzioni di connettività aggiuntive sotto forma di coppie chiave-valore.

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. Questa opzione ha una lunghezza massima di 260 caratteri.
HostNameInCertificate	Sostituzione del nome host per il certificato. Questa opzione ha una lunghezza massima di 255 caratteri.

Osservazioni:

Usare i processi di backup, copia e ripristino per eseguire il backup, la copia e il ripristino, quando possibile. Per avviare questi processi da un'operazione batch o da un'altra applicazione, chiamare la stored procedure sp_start_job.

La cronologia di log shipping creata da sqllogship è intercalata dalla cronologia creata dai processi di backup, copia e ripristino del log shipping. Se si prevede di usare ripetutamente sqllogship per eseguire operazioni di backup, copia o ripristino per una configurazione per il log shipping, prendere in considerazione di disabilitare il processo o i processi per il log shipping corrispondenti. Per ulteriori informazioni, vedere Disabilitare o Abilitare un'Attività.

L'applicazione sqllogship , SqlLogShip.exe, viene installata nella <drive>:\Program Files\Microsoft SQL Server\130\Tools\Binn directory .

Autorizzazioni

sqllogship usa l'autenticazione di Windows. L'account con autenticazione di Windows utilizzato per l'esecuzione del comando deve disporre delle autorizzazioni di accesso alle directory di Windows e delle autorizzazioni per SQL Server. Il requisito dipende dal fatto che il comando sqllogship specifichi l'opzione -backup, -copyo -restore .

Opzione	Accesso alla directory	Autorizzazioni
-backup	È richiesto l'accesso in lettura/scrittura alla directory di backup.	Richiede le stesse autorizzazioni dell'istruzione BACKUP . Per altre informazioni, vedere BACKUP.
-copy	È richiesto l'accesso in lettura alla directory di backup e l'accesso in scrittura alla directory di copia.	Sono richieste le stesse autorizzazioni necessarie per la stored procedure sp_help_log_shipping_secondary_database .
-restore	È richiesto l'accesso in lettura/scrittura alla directory di copia.	Richiede le stesse autorizzazioni dell'istruzione RESTORE . Per altre informazioni, vedere Istruzioni RESTORE.

Per individuare i percorsi delle directory di backup e copia, è possibile eseguire la sp_help_log_shipping_secondary_database stored procedure o visualizzare la log_shipping_secondary tabella in msdb. I percorsi della directory di backup e della directory di destinazione si trovano rispettivamente nelle backup_source_directory colonne e backup_destination_directory .

Contenuti correlati

• Informazioni sul log shipping (SQL Server)
• database_primari_per_la_spedizione_del_registro (Transact-SQL)
• log_shipping_secondary (Transact-SQL)
• sp_cleanup_log_shipping_history (Transact-SQL)
• sp_help_log_shipping_primary_database (Transact-SQL) - Questa funzione visualizza informazioni sulla configurazione del database primario nel contesto della spedizione dei registri.
• sp_help_log_shipping_secondary_database (Transact-SQL)
• sp_start_job (Transact-SQL)