sp_add_log_shipping_secondary_database(Transact-SQL)
로그 전달을 위한 보조 데이터베이스를 설정합니다.
구문
sp_add_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[ @primary_server = ] 'primary_server',
[ @primary_database = ] 'primary_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']
인수
- [ @secondary_database = ] 'secondary_database'
보조 데이터베이스의 이름입니다. secondary_database는 sysname이며 기본값은 없습니다.
- [ @primary_server = ] 'primary_server'
로그 전달 구성의 Microsoft SQL Server 데이터베이스 엔진에 대한 주 인스턴스의 이름입니다. primary_server는 sysname이며 NULL이 될 수 없습니다.
- [ @primary_database = ] 'primary_database'
주 서버의 데이터베이스 이름입니다. primary_database는 sysname이며 기본값은 없습니다.
- [ @restore_delay = ] 'restore_delay'
지정된 백업 파일을 복원하기까지 보조 서버가 대기하는 시간(분)입니다. restore_delay는 int이며 NULL일 수 없습니다. 기본값은 0입니다.
- [ @restore_all = ] 'restore_all'
1로 설정될 경우 보조 서버는 복원 작업 실행 시 모든 사용 가능한 트랜잭션 백업을 복원합니다. 1로 설정하지 않으면 파일 한 개를 복원한 후 중지됩니다. restore_all은 bit이며 NULL일 수 없습니다.
[ @restore_mode = ] 'restore_mode'
보조 데이터베이스의 복원 모드입니다.0 = NORECOVERY로 로그 복원.
1 = STANDBY로 로그 복원.
restore는 bit이며 NULL일 수 없습니다.
- [ @disconnect_users = ] 'disconnect_users'
1로 설정될 경우 복원 작업 수행 시 보조 데이터베이스에서 사용자 연결이 끊어집니다. 기본값은 0입니다. disconnect 사용자는 bit이며 NULL일 수 없습니다.
- [ @block_size = ] 'block_size'
백업 장치의 블록 크기로 사용되는 크기(바이트)입니다. block_size는 int이며 기본값은 -1입니다.
- [ @buffer_count = ] 'buffer_count'
백업 또는 복원 작업에서 사용하는 버퍼의 총 수입니다. buffer_count는 int이며 기본값은 -1입니다.
- [ @max_transfer_size = ] 'max_transfer_size'
SQL Server에서 백업 장치로 발급하는 최대 입력 또는 출력 요청의 크기(바이트)입니다. max_transfersize는 int이며 NULL일 수 있습니다.
- [ @restore_threshold = ] 'restore_threshold'
복원 작업 간 허용되는 시간(분)입니다. 이 시간이 지나면 경고가 발생합니다. restore_threshold는 int이며 NULL일 수 없습니다.
- [ @threshold_alert = ] 'threshold_alert'
백업 임계값이 초과될 때 발생하는 경고입니다. threshold_alert는 int이며 기본값은 14,420입니다.
- [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
backup_threshold를 초과할 때 경고 발생 여부를 지정합니다. 기본값인 1은 경고가 발생된다는 의미입니다. threshold_alert_enabled는 bit입니다.
- [ @history_retention_period = ] 'history_retention_period'
기록이 보존되는 시간(분)입니다. history_retention_period는 int이며 기본값은 NULL입니다. 지정된 값이 없으면 14420을 사용합니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
없음
주의
sp_add_log_shipping_secondary_database는 보조 서버에 있는 master 데이터베이스에서 실행해야 합니다. 이 저장 프로시저는 다음을 수행합니다.
- 보조 서버에서 주 로그 전달 데이터베이스 정보를 초기화하려면 이 저장 프로시저를 실행하기 전에 sp_add_log_shipping_secondary_primary를 호출해야 합니다.
- 제공된 인수를 사용하여 log_shipping_secondary_databases에서 보조 데이터베이스에 대한 항목을 추가합니다.
- 제공된 인수를 사용하여 보조 서버의 log_shipping_monitor_secondary에서 로컬 모니터 레코드를 추가합니다.
- 모니터 서버가 보조 서버와 다른 경우 제공된 인수를 사용하여 모니터 서버의 log_shipping_monitor_secondary에서 모니터 레코드를 추가합니다.
사용 권한
sysadmin 고정 서버 역할의 멤버만 이 프로시저를 실행할 수 있습니다.
예
다음 예에서는 sp_add_log_shipping_secondary_database 저장 프로시저를 사용하여 주 서버 TRIBECA에 주 데이터베이스 AdventureWorks가 있는 로그 전달 구성에서 데이터베이스 LogShipAdventureWorks를 보조 데이터베이스로 추가하는 방법을 보여 줍니다.
EXEC master.dbo.sp_add_log_shipping_secondary_database
@secondary_database = N'LogShipAdventureWorks'
,@primary_server = N'TRIBECA'
,@primary_database = N'AdventureWorks'
,@restore_delay = 0
,@restore_mode = 1
,@disconnect_users = 0
,@restore_threshold = 45
,@threshold_alert_enabled = 0
,@history_retention_period = 1440
GO