sqllogship 응용 프로그램sqllogship Application

sqllogship 응용 프로그램은 로그 전달 구성에 대해 백업, 복사, 복원 작업 및 관련 정리 태스크를 수행합니다.The sqllogship application performs a backup, copy, or restore operation and associated clean-up tasks for a log shipping configuration. 이 작업은 MicrosoftMicrosoft SQL ServerSQL Server 의 특정 인스턴스에서 특정 데이터베이스에 대해 수행됩니다.The operation is performed on a specific instance of MicrosoftMicrosoft SQL ServerSQL Server for a specific database.

항목 링크 아이콘 구문 표기 규칙에 대 한 참조 명령 프롬프트 유틸리티 참조 ( 데이터베이스 엔진 )합니다.Topic link icon For the syntax conventions, see Command Prompt Utility Reference (Database Engine).

구문Syntax


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

인수Arguments

-server instance_name-server instance_name
작업을 실행할 SQL ServerSQL Server 인스턴스를 지정합니다.Specifies the instance of SQL ServerSQL Server where the operation will run. 지정할 서버 인스턴스는 로그 전달 작업이 지정되는지 여부에 따라 달라집니다.The server instance to specify depends on which log-shipping operation is being specified. -backup의 경우 instance_name 은 로그 전달 구성의 주 서버 이름이어야 합니다.For -backup, instance_name must be the name of the primary server in a log shipping configuration. -copy 또는 -restore의 경우 instance_name 은 로그 전달 구성의 보조 서버 이름이어야 합니다.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
주 ID가 primary_id로 지정된 주 데이터베이스에 대한 백업 작업을 수행합니다.Performs a backup operation for the primary database whose primary ID is specified by primary_id. log_shipping_primary_databases 시스템 테이블에서 선택하거나 sp_help_log_shipping_primary_database 저장 프로시저를 사용하여 이 ID를 가져올 수 있습니다.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.

백업 작업은 백업 디렉터리에 로그 백업을 만듭니다.The backup operation creates the log backup in the backup directory. 그런 다음 sqllogship 응용 프로그램은 파일 보존 기간을 기준으로 모든 이전 백업 파일을 정리합니다.The sqllogship application then cleans out any old backup files, based on the file retention period. 다음으로 응용 프로그램은 주 서버 및 모니터 서버의 백업 작업에 대한 기록을 작성합니다.Next, the application logs history for the backup operation on the primary server and the monitor server. 마지막으로 응용 프로그램은 보존 기간을 기준으로 이전 기록 정보를 정리하는 sp_cleanup_log_shipping_history를 실행합니다.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
보조 ID가 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. log_shipping_secondary 시스템 테이블에서 선택하거나 sp_help_log_shipping_secondary_database 저장 프로시저를 사용하여 이 ID를 가져올 수 있습니다.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.

이 작업은 백업 디렉터리에서 대상 디렉터리로 백업 파일을 복사합니다.The operation copies the backup files from the backup directory to the destination directory. 그런 다음 sqllogship 응용 프로그램은 보조 서버 및 모니터 서버의 복사 작업에 대한 기록을 작성합니다.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
보조 ID가 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. sp_help_log_shipping_secondary_database 저장 프로시저를 사용하여 이 ID를 가져올 수 있습니다.You can obtain this ID by using the sp_help_log_shipping_secondary_database stored procedure.

최근 복원 지점 이후에 생성된 대상 디렉터리의 백업 파일이 데이터베이스 또는 보조 데이터베이스에 복원됩니다.Any backup files in the destination directory that were created after the most recent restore point are restored to the secondary database, or databases. 그런 다음 sqllogship 응용 프로그램은 파일 보존 기간을 기준으로 모든 이전 백업 파일을 정리합니다.The sqllogship application then cleans out any old backup files, based on the file retention period. 다음으로 응용 프로그램은 보조 서버 및 모니터 서버의 복원 작업에 대한 기록을 작성합니다.Next, the application logs history for the restore operation on the secondary server and the monitor server. 마지막으로 응용 프로그램은 보존 기간을 기준으로 이전 기록 정보를 정리하는 sp_cleanup_log_shipping_history를 실행합니다.Finally, the application runs sp_cleanup_log_shipping_history, which cleans out old history information, based on the retention period.

–verboselevel level–verboselevel level
로그 전달 기록에 추가된 메시지 수준을 지정합니다.Specifies the level of messages added to the log shipping history. level 은 다음 정수 중 하나입니다.level is one of the following integers:

levelLevel 설명Description
00 추적 및 디버깅 메시지를 출력하지 않습니다.Output no tracing and debugging messages.
11 오류 처리 메시지를 출력합니다.Output error-handling messages.
22 경고 및 오류 처리 메시지를 출력합니다.Output warnings and error-handling messages.
33 정보 메시지, 경고 및 오류 처리 메시지를 출력합니다.Output informational messages, warnings, and error-handling messages. 이 값은 기본값입니다.This is the default value.
44 모든 디버깅 및 추적 메시지를 출력합니다.Output all debugging and tracing messages.

–logintimeout timeout_value–logintimeout timeout_value
서버 인스턴스 로그인에 할당된 제한 시간 값을 지정합니다.Specifies the amount of time allotted for attempting to log in to the server instance before the attempt times out. 기본값은 15초입니다.The default is 15 seconds. timeout_valueint입니다.timeout_value is int.

-querytimeout timeout_value-querytimeout timeout_value
지정된 작업을 시작하는 데 할당된 제한 시간 값을 지정합니다.Specifies the amount of time allotted for starting the specified operation before the attempt times out. 기본값은 제한 시간 없음입니다.The default is no timeout period. timeout_valueint입니다.timeout_value is int.

주의Remarks

가능하면 백업, 복사 및 복원 작업을 사용하여 백업, 복사 및 복원을 수행하는 것이 좋습니다.We recommend that you use the backup, copy, and restore jobs to perform the backup, copy and restore when possible. 일괄 처리 작업 또는 다른 응용 프로그램에서 이러한 작업을 시작하려면 sp_start_job 저장 프로시저를 호출하세요.To start these jobs from a batch operation or other application, call the sp_start_job stored procedure.

sqllogship 에서 생성된 로그 전달 기록은 로그 전달 백업, 복사 및 복원 작업으로 생성된 기록과 섞여 있습니다.The log shipping history created by sqllogship is interspersed with the history created by log shipping backup, copy, and restore jobs. 로그 전달 구성에 대해 백업, 복사 또는 복원 작업을 수행하도록 sqllogship 을 반복적으로 사용하려면 해당 로그 전달 작업을 비활성화하는 것을 고려하십시오.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. 자세한 내용은 Disable or Enable a Job을 참조하세요.For more information, see Disable or Enable a Job.

sqllogship 응용 프로그램인 SqlLogShip.exe는 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.

사용 권한Permissions

sqllogship 은 Windows 인증을 사용합니다.sqllogship uses Windows Authentication. 명령이 실행될 Windows 인증 계정에는 Windows 디렉터리 액세스 권한 및 SQL ServerSQL Server 권한이 필요합니다.The Windows Authentication account where the command is run requires Windows directory access and SQL ServerSQL Server permissions. 요구 사항은 sqllogship 명령이 -backup, -copy또는 -restore 옵션을 지정하는지에 따라 다릅니다.The requirement depends on whether the sqllogship command specifies the -backup, -copy, or -restore option.

옵션Option 디렉터리 액세스 권한Directory access 사용 권한Permissions
-backup-backup 백업 디렉터리에 대한 읽기/쓰기 권한이 필요합니다.Requires read/write access to the backup directory. BACKUP 문과 같은 권한이 필요합니다.Requires the same permissions as the BACKUP statement. 자세한 내용은 BACKUP(Transact-SQL)을 참조하세요.For more information, see BACKUP (Transact-SQL).
-copy-copy 백업 디렉터리에 대한 읽기 권한과 복사 디렉터리에 대한 쓰기 권한이 필요합니다.Requires read access to the backup directory and write access to the copy directory. sp_help_log_shipping_secondary_database 저장 프로시저와 같은 권한이 필요합니다.Requires the same permissions as the sp_help_log_shipping_secondary_database stored procedure.
-restore-restore 복사 디렉터리에 대한 읽기/쓰기 권한이 필요합니다.Requires read/write access to the copy directory. RESTORE 문과 같은 권한이 필요합니다.Requires the same permissions as the RESTORE statement. 자세한 내용은 RESTORE(Transact-SQL)를 참조하세요.For more information, see RESTORE (Transact-SQL).
참고

백업 및 복사 디렉터리의 경로를 찾기 위해 sp_help_log_shipping_secondary_database 저장 프로시저를 실행하거나 msdblog_shipping_secondary 테이블을 볼 수 있습니다.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. 백업 디렉터리 및 대상 디렉터리의 경로는 backup_source_directorybackup_destination_directory 열에 각각 있습니다.The paths of the backup directory and destination directory are in the backup_source_directory and backup_destination_directory columns, respectively.

참고 항목See Also

로그 전달 정보(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)