sp_add_log_shipping_secondary_database(Transact-SQL)

적용 대상:SQL Server

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

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'

로그 전달 구성에서 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로 설정될 경우 보조 서버는 복원 작업 실행 시 모든 사용 가능한 트랜잭션 백업을 복원합니다. 그렇지 않으면 파일 한 개를 복원한 후 중지됩니다. @restore_all 비트이며 NULL일 수 없습니다.

[ @restore_mode = ] 'restore_mode'

보조 데이터베이스의 복원 모드입니다.

• 0: 다음을 사용하여 로그 복원 NORECOVERY
• 1: 다음을 사용하여 로그 복원 STANDBY

@restore_mode 비트이며 NULL일 수 없습니다.

[ @disconnect_users = ] 'disconnect_users'

이 값으로 1설정하면 복원 작업이 수행될 때 보조 데이터베이스에서 사용자의 연결이 끊어집니다. 기본값은 0입니다. @disconnect_users 비트이며 NULL일 수 없습니다.

[ @block_size = ] 'block_size'

백업 디바이스의 블록 크기로 사용되는 크기(바이트)입니다. @block_size 기본값이 -1인 int입니다.

[ @buffer_count = ] 'buffer_count'

백업 또는 복원 작업에서 사용하는 총 버퍼 수입니다. @buffer_count 기본값이 -1인 int입니다.

[ @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'

@restore_threshold 초과할 때 경고가 발생하는지 여부를 지정합니다. 값 1 (기본값)은 경고가 발생했음을 의미합니다. @threshold_alert_enabled 비트입니다.

[ @history_retention_period = ] '@history_retention_period'

기록이 유지되는 시간(분)입니다. @history_retention_period 기본값NULL인 int입니다. 값 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. 모니터 서버가 보조 서버 sp_add_log_shipping_secondary_database 와 다른 경우 제공된 인수를 사용하여 모니터 서버에 모니터 레코드 log_shipping_monitor_secondary 를 추가합니다.

사용 권한

sysadmin 고정 서버 역할의 멤버만 이 절차를 실행할 수 있습니다.

예제

이 예제에서는 저장 프로시저를 사용하여 sp_add_log_shipping_secondary_database 주 서버에 TRIBECA있는 주 데이터베이스 LogShipAdventureWorks 를 사용하여 로그 전달 구성에서 데이터베이스를 보조 데이터베이스 AdventureWorks2022 로 추가하는 방법을 보여 줍니다.

EXEC master.dbo.sp_add_log_shipping_secondary_database
    @secondary_database = N'LogShipAdventureWorks',
    @primary_server = N'TRIBECA',
    @primary_database = N'AdventureWorks2022',
    @restore_delay = 0,
    @restore_mode = 1,
    @disconnect_users = 0,
    @restore_threshold = 45,
    @threshold_alert_enabled = 0,
    @history_retention_period = 1440;
GO

관련 콘텐츠

• 로그 전달 정보(SQL Server)
• 시스템 저장 프로시저(Transact-SQL)