Applicazione sqllogshipsqllogship Application

L'applicazione sqllogship esegue un'operazione di backup, copia o ripristino e le attività di pulizia associate per una configurazione per il log shipping.The sqllogship application performs a backup, copy, or restore operation and associated clean-up tasks for a log shipping configuration. L'operazione viene eseguita su una specifica istanza di MicrosoftMicrosoft SQL ServerSQL Server per un database specifico.The operation is performed on a specific instance of MicrosoftMicrosoft SQL ServerSQL Server for a specific database.

Icona di collegamento argomento per le convenzioni della sintassi, vedere riferimento utilità prompt dei comandi ( motore di Database ).Topic link icon For the syntax conventions, see Command Prompt Utility Reference (Database Engine).

SintassiSyntax


sqllogship -server instance_name { -backup primary_id | -copy secondary_id | -restore secondary_id } [ –verboselevel level ] [ –logintimeout timeout_value ] [ -querytimeout timeout_value ]  

ArgomentiArguments

-server instance_name-server instance_name
Specifica l'istanza di SQL ServerSQL Server in cui verrà eseguita l'operazione.Specifies the instance of SQL ServerSQL Server where the operation will run. L'istanza del server da specificare dipende dall'operazione di distribuzione dei log specificata.The server instance to specify depends on which log-shipping operation is being specified. Nel caso dell'operazione -backup, instance_name deve essere il nome del server primario in una configurazione per il log shipping.For -backup, instance_name must be the name of the primary server in a log shipping configuration. Nel caso di un'operazione -copy o -restore, instance_name deve essere il nome del server secondario in una configurazione per il log shipping.For -copy or -restore, instance_name must be the name of a secondary server in a log shipping configuration.

-backup primary_id-backup primary_id
Esegue un'operazione di backup per il database primario corrispondente all'ID primario specificato tramite primary_id.Performs a backup operation for the primary database whose primary ID is specified by 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 .You can obtain this ID by selecting it from the log_shipping_primary_databases system table or by using the sp_help_log_shipping_primary_database stored procedure.

L'operazione di backup crea il backup del log nella directory di backup.The backup operation creates the log backup in the backup directory. L'applicazione sqllogship elimina quindi tutti i file di backup meno recenti in base al periodo di conservazione dei file.The sqllogship application then cleans out any old backup files, based on the file retention period. La cronologia per l'operazione di backup viene poi registrata dall'applicazione nel server primario e nel server di monitoraggio.Next, the application logs history for the backup operation on the primary server and the monitor server. L'applicazione esegue infine sp_cleanup_log_shipping_historyche elimina le informazioni sulla cronologia meno recenti in base al periodo di conservazione.Finally, the application runs sp_cleanup_log_shipping_history, which cleans out old history information, based on the retention period.

-copy secondary_id-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.Performs a copy operation to copy backups from the specified secondary server for the secondary database, or databases, whose secondary ID is specified by 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 .You can obtain this ID by selecting it from the log_shipping_secondary system table or by using the sp_help_log_shipping_secondary_database stored procedure.

L'operazione copia i file di backup dalla directory di backup alla directory di destinazione.The operation copies the backup files from the backup directory to the destination directory. L'applicazione sqllogship registra quindi la cronologia per l'operazione di copia nel server secondario e nel server di monitoraggio.The sqllogship application then logs the history for the copy operation on the secondary server and the monitor server.

-restore secondary_id-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.Performs a restore operation on the specified secondary server for the secondary database, or databases, whose secondary ID is specified by secondary_id. Per ottenere questo ID è possibile usare la stored procedure sp_help_log_shipping_secondary_database .You can obtain this ID by using the 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.Any backup files in the destination directory that were created after the most recent restore point are restored to the secondary database, or databases. L'applicazione sqllogship elimina quindi tutti i file di backup meno recenti in base al periodo di conservazione dei file.The sqllogship application then cleans out any old backup files, based on the file retention period. La cronologia per l'operazione di ripristino viene poi registrata dall'applicazione nel server secondario e nel server di monitoraggio.Next, the application logs history for the restore operation on the secondary server and the monitor server. L'applicazione esegue infine sp_cleanup_log_shipping_historyche elimina le informazioni sulla cronologia meno recenti in base al periodo di conservazione.Finally, the application runs sp_cleanup_log_shipping_history, which cleans out old history information, based on the retention period.

–verboselevel level–verboselevel level
Specifica il livello di messaggi aggiunti alla cronologia di log shipping.Specifies the level of messages added to the log shipping history. level può essere uno dei valori interi seguenti:level is one of the following integers:

levelLevel DescrizioneDescription
00 L'output non include messaggi di traccia e di debug.Output no tracing and debugging messages.
11 L'output include messaggi di gestione degli errori.Output error-handling messages.
22 L'output include messaggi di avviso e di gestione degli errori.Output warnings and error-handling messages.
33 L'output include messaggi informativi, di avviso e di gestione degli errori.Output informational messages, warnings, and error-handling messages. Si tratta del valore predefinito.This is the default value.
44 L'output include tutti i messaggi di debug e di traccia.Output all debugging and tracing messages.

–logintimeout timeout_value–logintimeout timeout_value
Specifica la quantità di tempo assegnata per un tentativo di accesso all'istanza del server prima del timeout.Specifies the amount of time allotted for attempting to log in to the server instance before the attempt times out. Il valore predefinito è 15 secondi.The default is 15 seconds. timeout_value is int.timeout_value is int.

-querytimeout timeout_value-querytimeout timeout_value
Specifica la quantità di tempo assegnata per l'avvio dell'operazione specificata prima del timeout del tentativo.Specifies the amount of time allotted for starting the specified operation before the attempt times out. Il valore predefinito non prevede un periodo di timeout.The default is no timeout period. timeout_value is int.timeout_value is int.

OsservazioniRemarks

È consigliabile utilizzare i processi di backup, copia e ripristino per eseguire le operazioni corrispondenti, quando possibile.We recommend that you use the backup, copy, and restore jobs to perform the backup, copy and restore when possible. Per avviare questi processi da un'operazione batch o un'altra applicazione, chiamare la stored procedure sp_start_job .To start these jobs from a batch operation or other application, call the sp_start_job stored procedure.

La cronologia di log shipping creata da sqllogship è intercalata dalla cronologia creata dai processi di backup, copia e ripristino del log shipping.The log shipping history created by sqllogship is interspersed with the history created by log shipping backup, copy, and restore jobs. 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.If you plan to use sqllogship repeatedly to perform backup, copy, or restore operations for a log shipping configuration, consider disabling the corresponding log shipping job or jobs. Per altre informazioni, vedere Disable or Enable a Job.For more information, see Disable or Enable a Job.

L'applicazione sqllogship , SqlLogShip.exe, è installata nella directory x:\Program Files\Microsoft SQL Server\130\Tools\Binn.The sqllogship application, SqlLogShip.exe, is installed in the x:\Program Files\Microsoft SQL Server\130\Tools\Binn directory.

AutorizzazioniPermissions

sqllogship usa l'autenticazione di Windows.sqllogship uses Windows Authentication. 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 ServerSQL Server .The Windows Authentication account where the command is run requires Windows directory access and SQL ServerSQL Server permissions. Il requisito dipende dal fatto che il comando sqllogship specifichi l'opzione -backup, -copyoppure -restore .The requirement depends on whether the sqllogship command specifies the -backup, -copy, or -restore option.

OpzioneOption Accesso alla directoryDirectory access AutorizzazioniPermissions
-backup-backup È richiesto l'accesso in lettura/scrittura alla directory di backup.Requires read/write access to the backup directory. Sono richieste le stesse autorizzazioni necessarie per l'istruzione BACKUP.Requires the same permissions as the BACKUP statement. Per altre informazioni, vedere BACKUP (Transact-SQL).For more information, see BACKUP (Transact-SQL).
-copy-copy È richiesto l'accesso in lettura alla directory di backup e l'accesso in scrittura alla directory di copia.Requires read access to the backup directory and write access to the copy directory. Sono richieste le stesse autorizzazioni necessarie per la stored procedure sp_help_log_shipping_secondary_database .Requires the same permissions as the sp_help_log_shipping_secondary_database stored procedure.
-restore-restore È richiesto l'accesso in lettura/scrittura alla directory di copia.Requires read/write access to the copy directory. Sono richieste le stesse autorizzazioni necessarie per l'istruzione RESTORE.Requires the same permissions as the RESTORE statement. Per altre informazioni, vedere RESTORE (Transact-SQL).For more information, see 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.To find out the paths of the backup and copy directories, you can run the sp_help_log_shipping_secondary_database stored procedure or view the log_shipping_secondary table 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 .The paths of the backup directory and destination directory are in the backup_source_directory and backup_destination_directory columns, respectively.

Vedere ancheSee Also

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