sp_add_log_shipping_secondary_database(Transact-SQL)

로그 전달을 위한 보조 데이터베이스를 설정합니다.

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'
  로그 전달 구성의 MicrosoftSQL 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 데이터베이스에서 실행해야 합니다. 이 저장 프로시저는 다음을 수행합니다.

1. 보조 서버에서 주 로그 전달 데이터베이스 정보를 초기화하려면 이 저장 프로시저를 실행하기 전에 sp_add_log_shipping_secondary_primary를 호출해야 합니다.

2. 제공된 인수를 사용하여 log_shipping_secondary_databases에서 보조 데이터베이스에 대한 항목을 추가합니다.

3. 제공된 인수를 사용하여 보조 서버의 log_shipping_monitor_secondary에서 로컬 모니터 레코드를 추가합니다.

4. 모니터 서버가 보조 서버와 다른 경우 제공된 인수를 사용하여 모니터 서버의 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

참고 항목

참조

시스템 저장 프로시저(Transact-SQL)

개념

로그 전달 테이블 및 저장 프로시저

관련 자료

로그 전달 관리