sp_change_log_shipping_secondary_database(Transact-SQL)sp_change_log_shipping_secondary_database (Transact-SQL)

이 항목은 다음에 적용됩니다.예SQL Server(2008부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

보조 데이터베이스 설정을 변경합니다.Changes secondary database settings.

항목 링크 아이콘 Transact-SQL 구문 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax


sp_change_log_shipping_secondary_database  
[ @secondary_database = ] 'secondary_database',  
[, [ @restore_delay = ] 'restore_delay']  
[, [ @restore_all = ] 'restore_all']  
[, [ @restore_mode = ] 'restore_mode']  
[, [ @disconnect_users = ] 'disconnect_users']  
[, [ @block_size = ] 'block_size']  
[, [ @buffer_count = ] 'buffer_count']  
[, [ @max_transfer_size = ] 'max_transfer_size']  
[, [ @restore_threshold = ] 'restore_threshold']   
[, [ @threshold_alert = ] 'threshold_alert']   
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled']   
[, [ @history_retention_period = ] 'history_retention_period']  

인수Arguments

[ @restore_delay = ] 'restore_delay'[ @restore_delay = ] 'restore_delay'
보조 서버가 지정된 백업 파일을 복원하기 전에 대기하는 시간(분)입니다.The amount of time, in minutes, that the secondary server waits before restoring a given backup file. restore_delayint NULL 일 수 없습니다.restore_delay is int and cannot be NULL. 기본값은 0입니다.The default value is 0.

[ @restore_all = ] 'restore_all'[ @restore_all = ] 'restore_all'
1로 설정될 경우 보조 서버는 복원 작업 실행 시 모든 사용 가능한 트랜잭션 백업을 복원합니다.If set to 1, the secondary server restores all available transaction log backups when the restore job runs. 그렇지 않으면 파일을 하나 복원한 후 중지합니다.Otherwise, it stops after one file has been restored. restore_all비트 NULL 일 수 없습니다.restore_all is bit and cannot be NULL.

[ @restore_mode = ] 'restore_mode'[ @restore_mode = ] 'restore_mode'
보조 데이터베이스의 복원 모드입니다.The restore mode for the secondary database.

0 = NORECOVERY로 로그 복원0 = restore log with NORECOVERY.

1 = STANDBY로 로그 복원1 = restore log with STANDBY.

복원비트 NULL 일 수 없습니다.restore is bit and cannot be NULL.

[ @disconnect_users = ] 'disconnect_users'[ @disconnect_users = ] 'disconnect_users'
1로 설정될 경우 복원 작업 수행 시 보조 데이터베이스에서 사용자 연결이 끊어집니다.If set to 1, users is disconnected from the secondary database when a restore operation is performed. 기본값 = 0Default = 0. disconnect_users비트 NULL 일 수 없습니다.disconnect_users is bit and cannot be NULL.

[ @block_size = ] 'block_size'[ @block_size = ] 'block_size'
백업 장치의 블록 크기로 사용되는 크기(바이트)입니다.The size, in bytes, that is used as the block size for the backup device. block_sizeint 기본값은-1입니다.block_size is int with a default value of -1.

[ @buffer_count = ] 'buffer_count'[ @buffer_count = ] 'buffer_count'
백업 또는 복원 작업에 사용되는 버퍼의 총 개수입니다.The total number of buffers used by the backup or restore operation. buffer_countint 기본값은-1입니다.buffer_count is int with a default value of -1.

[ @max_transfer_size = ] 'max_transfer_size'[ @max_transfer_size = ] 'max_transfer_size'
SQL ServerSQL Server에서 백업 장치로 발급하는 최대 입력 또는 출력 요청의 크기(바이트)입니다.The size, in bytes, of the maximum input or output request which is issued by SQL ServerSQL Server to the backup device. max_transfersizeint NULL 일 수 있습니다.max_transfersize is int and can be NULL.

[ @restore_threshold = ] 'restore_threshold'[ @restore_threshold = ] 'restore_threshold'
복원 작업 간 허용되는 시간(분)입니다. 이 시간이 지나면 경고가 발생합니다.The number of minutes allowed to elapse between restore operations before an alert is generated. restore_thresholdint NULL 일 수 없습니다.restore_threshold is int and cannot be NULL.

[ @threshold_alert = ] 'threshold_alert'[ @threshold_alert = ] 'threshold_alert'
복원 임계값을 초과할 경우 발생하는 경고입니다.Is the alert to be raised when the restore threshold is exceeded. threshold_alertint, 14420이 기본값입니다.threshold_alert is int, with a default of 14420.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'[ @threshold_alert_enabled = ] 'threshold_alert_enabled'
경고는 되는지 여부를 지정 발생 시기 restore_threshold을 초과 합니다.Specifies whether an alert will be raised when restore_thresholdis exceeded. 1 = 설정, 0 = 해제1 = enabled; 0 = disabled. threshold_alert_enabled비트 NULL 일 수 없습니다.threshold_alert_enabled is bit and cannot be NULL.

[ @history_retention_period = ] 'history_retention_period'[ @history_retention_period = ] 'history_retention_period'
기록이 보존되는 기간(분)입니다.Is the length of time in minutes in which the history will be retained. history_retention_periodint합니다. 1440 값은 지정 되지 않은 경우에 사용 됩니다.history_retention_period is int. A value of 1440 will be used if none is specified.

반환 코드 값Return Code Values

0(성공) 또는 1(실패)0 (success) or 1 (failure)

결과 집합Result Sets

InclusionThresholdSettingNone

주의Remarks

sp_change_log_shipping_secondary_database 에서 실행 되어야 합니다는 마스터 보조 서버에서 데이터베이스.sp_change_log_shipping_secondary_database must be run from the master database on the secondary server. 이 저장 프로시저는 다음을 수행합니다.This stored procedure does the following:

  1. 설정을 변경는 log_shipping_secondary_database 필요에 따라 기록 합니다.Changes the settings in the log_shipping_secondary_database records as necessary.

  2. 로컬 모니터 레코드를 변경 log_shipping_monitor_secondary 보조 서버에서 사용 하 여 제공 된 인수를 필요한 경우.Changes the local monitor record in log_shipping_monitor_secondary on the secondary server using supplied arguments, if necessary.

PermissionsPermissions

구성원만는 sysadmin 고정된 서버 역할에서이 프로시저를 실행할 수 있습니다.Only members of the sysadmin fixed server role can run this procedure.

Examples

이 예제에서는 사용 하 여 sp_change_log_shipping_secondary_database 보조 데이터베이스 매개 변수는 데이터베이스에 대 한 업데이트 LogShipAdventureWorks합니다.This example illustrates using sp_change_log_shipping_secondary_database to update secondary database parameters for the database LogShipAdventureWorks.

EXEC master.dbo.sp_change_log_shipping_secondary_database   
 @secondary_database =  'LogShipAdventureWorks'  
,  @restore_delay = 0  
,  @restore_all = 1  
,  @restore_mode = 0  
,  @disconnect_users = 0  
,  @threshold_alert = 14420  
,  @threshold_alert_enabled = 1  
,  @history_retention_period = 14420;  

관련 항목:See Also

로그 전달 (에 대 한 SQL Server ) About Log Shipping (SQL Server)
시스템 저장 프로시저(Transact-SQL)System Stored Procedures (Transact-SQL)