Applicazione sqllogship

Si applica a:SQL Server

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

Per le convenzioni di sintassi, vedere Guida di riferimento alle utilità del prompt dei comandi (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 ]  

Argomenti

-serverinstance_name
Specifica l'istanza di SQL Server in cui verrà eseguita l'operazione. L'istanza del server da specificare dipende dall'operazione di distribuzione dei log specificata. Nel caso dell'operazione -backup, instance_name deve essere il nome del server primario in una configurazione per il log shipping. Nel caso di un'operazione -copy o -restore, instance_name deve essere il nome del server secondario in una configurazione per il log shipping.

-backupprimary_id
Esegue un'operazione di backup per il database primario corrispondente all'ID primario specificato tramite primary_id. Per ottenere questo ID, selezionarlo dalla tabella di sistema log_shipping_primary_databases oppure usare 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. L'applicazione esegue infine sp_cleanup_log_shipping_historyche elimina le informazioni sulla cronologia meno recenti in base al periodo di conservazione.

-copysecondary_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. Per ottenere questo ID, selezionarlo dalla tabella di sistema log_shipping_secondary oppure usare 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.

-restoresecondary_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. Per ottenere questo ID è possibile usare la stored procedure sp_help_log_shipping_secondary_database .

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. L'applicazione esegue infine sp_cleanup_log_shipping_historyche elimina le informazioni sulla cronologia meno recenti in base al periodo di conservazione.

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

Livello	Description
0	L'output non include messaggi di traccia e di debug.
1	L'output include messaggi di gestione degli errori.
2	L'output include messaggi di avviso e di gestione degli errori.
3	L'output include messaggi informativi, di avviso e di gestione degli errori. Questo è il valore predefinito.
4	L'output include tutti i messaggi di debug e di traccia.

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

-querytimeouttimeout_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 is int.

Osservazioni:

È consigliabile utilizzare i processi di backup, copia e ripristino per eseguire le operazioni corrispondenti, quando possibile. Per avviare questi processi da un'operazione batch o 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 altre informazioni, vedere Disable or Enable a Job.

L'applicazione sqllogship , SqlLogShip.exe, è installata nella directory x:\Program Files\Microsoft SQL Server\130\Tools\Binn.

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, -copyoppure -restore .

Opzione	Accesso alla directory	Autorizzazioni
-backup	È richiesto l'accesso in lettura/scrittura alla directory di backup.	Sono richieste le stesse autorizzazioni necessarie per l'istruzione BACKUP. Per altre informazioni, vedere BACKUP (Transact-SQL).
-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.	Sono richieste le stesse autorizzazioni necessarie per l'istruzione RESTORE. Per altre informazioni, vedere RESTORE (Transact-SQL).

Nota

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

Vedi anche

Informazioni sul log shipping (SQL Server)
log_shipping_primary_databases (Transact-SQL)
log_shipping_secondary (Transact-SQL)
sp_cleanup_log_shipping_history (Transact-SQL)
sp_help_log_shipping_primary_database (Transact-SQL)
sp_help_log_shipping_secondary_database (Transact-SQL)
sp_start_job (Transact-SQL)