기본 백업 및 복원 사용 - Amazon Relational Database Service
데이터베이스 백업데이터베이스 복원로그 복원복원 마무리부분적으로 복원된 데이터베이스작업 취소작업 상태 추적

기본 백업 및 복원 사용

기본 백업 및 복원을 활성화하고 구성한 다음에는 사용하기 시작할 수 있습니다. 먼저 Microsoft SQL Server 데이터베이스에 연결한 다음 해당 작업을 위한 Amazon RDS 저장 프로시저를 호출합니다. 데이터베이스 연결 방법에 대한 자세한 내용은 Microsoft SQL Server DB 인스턴스에 연결 단원을 참조하십시오.

저장 프로시저 중에는 Amazon S3 버킷과 파일에 ARN(Amazon 리소스 이름)을 제공해야 하는 것도 있습니다. ARN의 형식은 arn:aws:s3:::bucket_name/file_name.extension입니다. Amazon S3에서는 ARN에 계정 번호나 AWS 리전을 요구하지 않습니다.

KMS 키(선택 사항)도 제공하는 경우 키의 ARN 형식은 arn:aws:kms:region:account-id:key/key-id입니다. 자세한 내용은 Amazon 리소스 이름(ARN) 및 AWS 서비스 네임스페이스를 참조하세요. 대칭 암호화 KMS 키를 사용하여 백업을 암호화해야 합니다. Amazon RDS에서는 비대칭 KMS 키가 지원되지 않습니다. 자세한 내용은 AWS Key Management Service 개발자 안내서의 대칭 암호화 KMS 키 생성을 참조하세요.

참고

KMS 키를 사용하는지 여부에 관계없이 기본 백업 및 복원 작업을 통해 S3에 업로드된 파일에 대해 기본값으로 서버 측 고급 암호화 표준(AES) 256비트 암호화를 사용할 수 있습니다.

각각의 저장 프로시저를 호출하는 방법에 대한 지침은 다음 주제를 참조하십시오.

데이터베이스 백업

데이터베이스를 백업하려면 rds_backup_database 저장 프로시저를 사용하십시오.

참고

유지 관리 기간 중 또는 Amazon RDS에서 스냅샷을 만드는 동안에는 데이터베이스를 백업할 수 없습니다.

사용법

exec msdb.dbo.rds_backup_database
	@source_db_name='database_name',
	@s3_arn_to_backup_to='arn:aws:s3:::bucket_name/file_name.extension',
	[@kms_master_key_arn='arn:aws:kms:region:account-id:key/key-id'],	
	[@overwrite_s3_backup_file=0|1],
	[@block_size=512|1024|2048|4096|8192|16384|32768|65536],
        [@max_transfer_size=n],
        [@buffer_count=n],
	[@type='DIFFERENTIAL|FULL'],
	[@number_of_files=n];

다음 파라미터는 필수 파라미터입니다.

  • @source_db_name – 백업할 데이터베이스의 이름입니다.

  • @s3_arn_to_backup_to – 백업에 사용할 Amazon S3 버킷과 백업 파일 이름을 나타내는 ARN입니다.

    파일에는 어떤 확장명이든 있을 수 있지만 .bak이 주로 사용됩니다.

다음 파라미터는 선택적입니다.

  • @kms_master_key_arn – 항목을 암호화하는 데 사용할 대칭 암호화 KMS 키의 ARN입니다.

    • 기본 암호화 키는 사용할 수 없습니다. 기본 키를 사용하면 데이터베이스가 백업되지 않습니다.

    • KMS 키 식별자를 지정하지 않으면 백업 파일이 암호화되지 않습니다. 자세한 내용은 Amazon RDS 리소스 암호화 단원을 참조하십시오.

    • KMS 키를 지정하면 클라이언트 측 암호화가 사용됩니다.

    • Amazon RDS에서는 비대칭 KMS 키가 지원되지 않습니다. 자세한 내용은 AWS Key Management Service 개발자 안내서의 대칭 암호화 KMS 키 생성을 참조하세요.

  • @overwrite_s3_backup_file – 기존 백업 파일을 덮어쓸지 여부를 나타내는 값입니다.

    • 0 – 기존 파일을 덮어쓰지 않습니다. 이 값이 기본값입니다.

      @overwrite_s3_backup_file을 0으로 설정하면 파일이 이미 존재할 경우 오류를 반환합니다.

    • 1 – 백업 파일이 아니더라도 지정된 이름이 있는 기존 파일을 덮어씁니다.

  • @type – 백업 유형입니다.

    • DIFFERENTIAL – 차등 백업을 수행합니다.

    • FULL – 전체 백업을 수행합니다. 이 값이 기본값입니다.

    차등 백업은 마지막 전체 백업을 기반을 합니다. 차등 백업이 작동할 수 있도록 마지막 전체 백업과 차등 백업 간에는 스냅샷을 만들 수 없습니다. 차등 백업을 만들려고 하는데 스냅샷이 이미 있으면 차등 백업을 진행하기 전에 다른 전체 백업을 만드십시오.

    다음 예제 SQL 쿼리를 사용하여 마지막 전체 백업 또는 스냅샷을 찾을 수 있습니다.

    select top 1
database_name
, 	backup_start_date
, 	backup_finish_date
from    msdb.dbo.backupset
where   database_name='mydatabase'
and     type = 'D'
order by backup_start_date desc;

  • @number_of_files – 백업을 분할(청크)할 파일 수입니다. 최대 개수는 10입니다.

    • 다중 파일 백업은 전체 백업과 차등 백업에 모두 지원됩니다.

    • 값 1을 입력하거나 파라미터를 생략하면 단일 백업 파일이 생성됩니다.

    파일에 공통으로 사용되는 접두사를 입력한 다음 접미사로 별표(*)를 붙입니다. 별표는 S3 ARN의 file_name 부분 아무 곳이나 지정할 수 있습니다. 별표는 생성된 파일에서 일련의 영숫자 문자열로 대체되며 1-of-number_of_files부터 시작합니다.

    예를 들어, S3 ARN의 파일 이름이 backup*.bak이고 @number_of_files=4를 설정한 경우 생성되는 백업 파일은 backup1-of-4.bak, backup2-of-4.bak, backup3-of-4.bak 및 backup4-of-4.bak입니다.

    • 파일 이름이 이미 존재하고 @overwrite_s3_backup_file이 0이면 오류가 반환됩니다.

    • 다중 파일 백업에는 S3 ARN의 file_name 부분에 별표를 하나만 지정할 수 있습니다.

    • 단일 파일 백업에는 S3 ARN의 file_name 부분에 별표를 여러 개 지정할 수 있습니다. 별표는 생성된 파일 이름에서 제거되지 않습니다.

  • @block_size - 백업 작업의 물리적 블록 크기를 지정하는 블록 크기(바이트)입니다. 유효한 값은 512, 1024, 2048, 4096, 8192, 16384, 32768, 65536입니다.

  • @max_transfer_size – 최대 전송 크기는 백업 프로세스 중에 I/O 작업당 전송되는 데이터 볼륨의 상한(바이트)을 나타냅니다. 유효한 값은 65,536바이트(64KB)의 배수로, 최대 4,194,304바이트(4MB)입니다.

  • @buffer_count - 백업 프로세스에 사용할 I/O 버퍼의 총 수입니다.

예시

예 차등 백업
exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup1.bak',
@overwrite_s3_backup_file=1,
@type='DIFFERENTIAL';
예 암호화를 사용하는 전체 백업
exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup1.bak',
@kms_master_key_arn='arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE',
@overwrite_s3_backup_file=1,
@type='FULL';
예 다중 파일 백업
exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak',
@number_of_files=4;
예 다중 파일 차등 백업
exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak',
@type='DIFFERENTIAL',
@number_of_files=4;
예 암호화를 사용한 다중 파일 백업
exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak',
@kms_master_key_arn='arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE',
@number_of_files=4;
예 S3 덮어쓰기를 사용한 다중 파일 백업
exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak',
@overwrite_s3_backup_file=1,
@number_of_files=4;
예 블록 크기를 사용한 백업
exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak',
@block_size=512;
예 @max_transfer_size 및 @buffer_count를 사용한 멀티파일 백업
exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak',
@number_of_files=4,
@max_transfer_size=4194304,
@buffer_count=10;
예 @number_of_files 파라미터를 사용하는 단일 파일 백업

이 예제에서는 backup*.bak 백업 파일을 생성합니다.

exec msdb.dbo.rds_backup_database
@source_db_name='mydatabase',
@s3_arn_to_backup_to='arn:aws:s3:::mybucket/backup*.bak',
@number_of_files=1;

데이터베이스 복원

데이터베이스를 복원하려면 rds_restore_database 저장 프로시저를 호출합니다. 복원 태스크가 완료되고 데이터베이스가 열린 후 Amazon RDS가 데이터베이스의 초기 스냅샷을 생성합니다.

사용법

exec msdb.dbo.rds_restore_database
	@restore_db_name='database_name',
	@s3_arn_to_restore_from='arn:aws:s3:::bucket_name/file_name.extension',
	@with_norecovery=0|1,
	[@kms_master_key_arn='arn:aws:kms:region:account-id:key/key-id'],
        [@block_size=512|1024|2048|4096|8192|16384|32768|65536],
        [@max_transfer_size=n],
        [@buffer_count=n],
	[@type='DIFFERENTIAL|FULL'];

다음 파라미터는 필수 파라미터입니다.

  • @restore_db_name – 복원할 데이터베이스의 이름입니다. 데이터베이스 이름은 고유합니다. 기존 데이터베이스와 이름이 같은 데이터베이스는 복원할 수 없습니다.

  • @s3_arn_to_restore_from – 데이터베이스를 복원하는 데 사용되는 백업 파일의 Amazon S3 접두사 및 이름을 나타내는 ARN입니다.

    • 단일 파일 백업의 경우 전체 파일 이름을 입력하십시오.

    • 다중 파일 백업의 경우 파일에 공통으로 사용되는 접두사를 제공한 다음 접미사로 별표(*)를 붙입니다.

    • @s3_arn_to_restore_from이 비어 있으면 다음 오류가 반환됩니다. S3 ARN prefix cannot be empty(S3 ARN 접두사는 비워 둘 수 없습니다).

차등 복원에는 다음 파라미터가 필수적이지만 전체 복원에는 선택적입니다.

  • @with_norecovery – 복원 작업에 사용할 복구 절입니다.

    • RECOVERY로 복원하려면 0으로 설정합니다. 이 경우 데이터베이스는 복원 후 온라인 상태입니다.

    • NORECOVERY로 복원하려면 1로 설정합니다. 이 경우 데이터베이스는 복원 작업 완료 후 RESTORING 상태로 유지됩니다. 이 방법을 사용하면 나중에 차등 복원을 수행할 수 있습니다.

    • DIFFERENTIAL 복원의 경우 0 또는 1을 지정하십시오.

    • FULL 복원의 경우, 이 값은 기본적으로 0로 설정됩니다.

다음 파라미터는 선택적입니다.

  • @kms_master_key_arn – 백업 파일을 암호화한 경우 파일 복호화에 사용할 KMS 키입니다.

    KMS 키를 지정하면 클라이언트 측 암호화가 사용됩니다.

  • @type – 복원의 유형입니다. 유효한 형식은 DIFFERENTIAL 및 FULL입니다. 기본 값은 FULL입니다.

  • @block_size - 백업 작업의 물리적 블록 크기를 지정하는 블록 크기(바이트)입니다. 유효한 값은 512, 1024, 2048, 4096, 8192, 16384, 32768, 65536입니다.

  • @max_transfer_size – 최대 전송 크기는 백업 프로세스 중에 I/O 작업당 전송되는 데이터 볼륨의 상한(바이트)을 나타냅니다. 유효한 값은 65,536바이트(64KB)의 배수로, 최대 4,194,304바이트(4MB)입니다.

  • @buffer_count - 백업 프로세스에 사용할 I/O 버퍼의 총 수입니다.

참고

차등 복원의 경우 데이터베이스가 RESTORING 상태이거나 NORECOVERY로 복원하는 작업이 이미 존재해야 합니다.

데이터베이스가 온라인 상태인 동안 나중에 차등 백업을 복원할 수 없습니다.

이미 RECOVERY로 복원 작업을 보류 중인 데이터베이스에 대해서는 복원 작업을 제출할 수 없습니다.

NORECOVERY로 전체 복원 및 차등 복원은 다중 AZ 인스턴스에서 지원되지 않습니다.

읽기 전용 복제본을 사용하여 다중 AZ 인스턴스에서 데이터베이스를 복원하는 것은 다중 AZ 인스턴스에서 데이터베이스를 복원하는 것과 유사합니다. 복제본에서 데이터베이스를 복원하기 위해 추가 작업을 수행할 필요가 없습니다.

예시

예 단일 파일 복원
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak';
예 다중 파일 복원

여러 파일을 복원하는 동안 오류를 방지하려면 모든 백업 파일의 접두사가 같고 다른 파일은 이 접두사를 사용하지 않아야 합니다.

exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup*';
예 RECOVERY로 전체 데이터베이스 복원

다음 세 가지 예는 동일한 작업, RECOVERY를 사용한 전체 복원을 수행합니다.

exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak';
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak',
[@type='DIFFERENTIAL|FULL'];
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak',
@type='FULL',
@with_norecovery=0;
예 암호화로 전체 데이터베이스 복원
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak',
@kms_master_key_arn='arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE';
예 블록 크기를 사용한 복원
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak',
@block_size=512;
예 @max_transfer_size 및 @buffer_count를 사용한 멀티파일 복원
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup*',
@max_transfer_size=4194304,
@buffer_count=10;
예 NORECOVERY로 전체 데이터베이스 복원
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak',
@type='FULL',
@with_norecovery=1;
예 NORECOVERY로 차등 복원
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak',
@type='DIFFERENTIAL',
@with_norecovery=1;
예 RECOVERY로 차등 복원
exec msdb.dbo.rds_restore_database
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/backup1.bak',
@type='DIFFERENTIAL',
@with_norecovery=0;

로그 복원

로그를 복원하려면 rds_restore_log 저장 프로시저를 호출합니다.

사용법

exec msdb.dbo.rds_restore_log 
	@restore_db_name='database_name',
	@s3_arn_to_restore_from='arn:aws:s3:::bucket_name/log_file_name.extension',
	[@kms_master_key_arn='arn:aws:kms:region:account-id:key/key-id'],
	[@with_norecovery=0|1],
	[@stopat='datetime'],
	[@block_size=512|1024|2048|4096|8192|16384|32768|65536],
        [@max_transfer_size=n],
        [@buffer_count=n];

다음 파라미터는 필수 파라미터입니다.

  • @restore_db_name – 로그를 복원할 데이터베이스의 이름입니다.

  • @s3_arn_to_restore_from – 로그를 복원하는 데 사용되는 로그 파일의 Amazon S3 접두사 및 이름을 나타내는 ARN입니다. 파일에는 어떤 확장명이든 있을 수 있지만 .trn이 주로 사용됩니다.

    @s3_arn_to_restore_from이 비어 있으면 다음 오류가 반환됩니다. S3 ARN prefix cannot be empty(S3 ARN 접두사는 비워 둘 수 없습니다).

다음 파라미터는 선택적입니다.

  • @kms_master_key_arn – 로그를 암호화한 경우, 로그 복호화에 사용할 KMS 키입니다.

  • @with_norecovery – 복원 작업에 사용할 복구 절입니다. 기본값은 1입니다.

    • RECOVERY로 복원하려면 0으로 설정합니다. 이 경우 데이터베이스는 복원 후 온라인 상태입니다. 데이터베이스가 온라인 상태인 동안 더 이상 로그 백업을 복원할 수 없습니다.

    • NORECOVERY로 복원하려면 1로 설정합니다. 이 경우 데이터베이스는 복원 작업 완료 후 RESTORING 상태로 유지됩니다. 이 방법을 사용하면 나중에 로그 복원을 수행할 수 있습니다.

  • @stopat – 데이터베이스가 지정된 날짜 및 시간(날짜 시간 형식)에서 해당 상태로 복원되도록 지정하는 값입니다. 지정된 날짜 및 시간 이전에 작성된 트랜잭션 로그 레코드만 데이터베이스에 적용됩니다.

    이 파라미터를 지정하지 않으면(NULL 인 경우) 전체 로그가 복원됩니다.

  • @block_size - 백업 작업의 물리적 블록 크기를 지정하는 블록 크기(바이트)입니다. 유효한 값은 512, 1024, 2048, 4096, 8192, 16384, 32768, 65536입니다.

  • @max_transfer_size – 최대 전송 크기는 백업 프로세스 중에 I/O 작업당 전송되는 데이터 볼륨의 상한(바이트)을 나타냅니다. 유효한 값은 65,536바이트(64KB)의 배수로, 최대 4,194,304바이트(4MB)입니다.

  • @buffer_count - 백업 프로세스에 사용할 I/O 버퍼의 총 수입니다.

참고

로그 복원의 경우 데이터베이스가 복원 상태이거나 NORECOVERY로 복원하는 작업이 이미 존재해야 합니다.

데이터베이스가 온라인 상태인 동안 로그 백업을 복원할 수 없습니다.

이미 RECOVERY로 복원 작업을 보류 중인 데이터베이스에서는 로그 복원 작업을 제출할 수 없습니다.

다중 AZ 인스턴스에는 로그 복원이 지원되지 않습니다.

예시

예 로그 복원
exec msdb.dbo.rds_restore_log
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn';
예 암호화로 로그 복원
exec msdb.dbo.rds_restore_log
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn',
@kms_master_key_arn='arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE';
예 NORECOVERY로 로그 복원

다음 두 가지 예는 동일한 작업, NORECOVERY를 사용한 로그 복원을 수행합니다.

exec msdb.dbo.rds_restore_log
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn',
@with_norecovery=1;
exec msdb.dbo.rds_restore_log
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn';
예 블록 크기를 사용한 복원
exec msdb.dbo.rds_restore_log
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn',
@block_size=512;
예 RECOVERY로 로그 복원
exec msdb.dbo.rds_restore_log
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn',
@with_norecovery=0;
예 STOPAT 절로 로그 복원
exec msdb.dbo.rds_restore_log
@restore_db_name='mydatabase',
@s3_arn_to_restore_from='arn:aws:s3:::mybucket/mylog.trn',
@with_norecovery=0,
@stopat='2019-12-01 03:57:09';

데이터베이스 복원 마무리

@with_norecovery=1을 사용하여 데이터베이스에서 마지막 복원 작업을 수행한 경우, 데이터베이스는 이제 RESTORING 상태입니다. rds_finish_restore 저장 프로시저를 사용하여 정상적으로 작동할 이 데이터베이스를 엽니다.

사용법

exec msdb.dbo.rds_finish_restore @db_name='database_name';
참고

이 방법을 사용하려면 데이터베이스가 보류 중인 복원 작업 없이 RESTORING 상태여야 합니다.

다중 AZ 인스턴스에는 rds_finish_restore 프로시저가 지원되지 않습니다.

데이터베이스 복원을 마치려면 마스터 로그인을 사용하십시오. 또는 가장 최근에 NORECOVERY로 데이터베이스나 로그를 복원한 사용자 로그인 정보를 사용하십시오.

부분적으로 복원된 데이터베이스 작업

부분적으로 복원된 데이터베이스 삭제

부분적으로 복원된 데이터베이스를 삭제하려면(RESTORING 상태로 남음), rds_drop_database 저장 프로시저를 사용하십시오.

exec msdb.dbo.rds_drop_database @db_name='database_name';
참고

이미 보류 중인 복원 작업이 있거나 복원 작업을 마친 데이터베이스에 대해서는 DROP 데이터베이스 요청을 제출할 수 없습니다.

데이터베이스를 삭제하려면 마스터 로그인을 사용합니다. 또는 가장 최근에 NORECOVERY로 데이터베이스나 로그를 복원한 사용자 로그인 정보를 사용하십시오.

부분적으로 복원된 데이터베이스에 대한 스냅샷 복원 및 특정 시점으로 복구 동작

원본 인스턴스에서 부분적으로 복원된 데이터베이스(RESTORING 상태로 남음)는 스냅샷 복원 및 특정 시점으로 복구 도중에 대상 인스턴스에서 삭제됩니다.

작업 취소

백업 또는 복원 작업을 취소하려면 rds_cancel_task 저장 프로시저를 호출합니다.

참고

FINISH_RESTORE 작업을 취소할 수 없습니다.

사용법

exec msdb.dbo.rds_cancel_task @task_id=ID_number;

다음 파라미터는 필수입니다.

  • @task_id – 취소할 작업의 ID입니다. 작업 ID는 rds_task_status를 호출하여 확인할 수 있습니다.

작업 상태 추적

백업 및 복원 작업의 상태를 추적하려면 rds_task_status 저장 프로시저를 호출합니다. 파라미터를 제공하지 않으면 이 저장 프로시저는 모든 작업의 상태를 반환합니다. 작업 상태는 약 2분마다 업데이트됩니다. 작업 기록은 36일 동안 보존됩니다.

사용법

exec msdb.dbo.rds_task_status
	[@db_name='database_name'],
	[@task_id=ID_number];

다음 파라미터는 선택적입니다.

  • @db_name – 작업 상태를 표시할 데이터베이스의 이름입니다.

  • @task_id – 작업 상태를 표시할 작업의 ID입니다.

예시

예 특정 작업의 상태 나열
exec msdb.dbo.rds_task_status @task_id=5;
예 특정 데이터베이스 및 작업의 상태 나열
exec msdb.dbo.rds_task_status
@db_name='my_database',
@task_id=5;
예 특정 데이터베이스의 모든 작업 및 상태 나열
exec msdb.dbo.rds_task_status @db_name='my_database';
예 현재 인스턴스의 모든 작업 및 상태 나열
exec msdb.dbo.rds_task_status;

응답

rds_task_status 저장 프로시저는 다음과 같은 열을 반환합니다.

열 설명

task_id

작업의 ID입니다.

task_type

입력 파라미터에 따라 다음과 같은 작업 유형:

  • 백업 작업의 경우:

    • BACKUP_DB – 전체 데이터베이스 백업

    • BACKUP_DB_DIFFERENTIAL – 차등 데이터베이스 백업

  • 복원 작업의 경우:

    • RESTORE_DB – RECOVERY로 전체 데이터베이스 복원

    • RESTORE_DB_NORECOVERY – NORECOVERY로 전체 데이터베이스 복원

    • RESTORE_DB_DIFFERENTIAL – RECOVERY로 차등 데이터베이스 복원

    • RESTORE_DB_DIFFERENTIAL_NORECOVERY – NORECOVERY로 차등 데이터베이스 복원

    • RESTORE_DB_LOG – RECOVERY로 로그 복원

    • RESTORE_DB_LOG_NORECOVERY – NORECOVERY로 로그 복원

  • 복원을 마치는 작업의 경우:

    • FINISH_RESTORE – 복원을 마치고 데이터베이스 열기

다음 복원 작업이 완료되고 데이터베이스가 열린 후 Amazon RDS가 데이터베이스의 최초 스냅샷을 만듭니다.

  • RESTORE_DB

  • RESTORE_DB_DIFFERENTIAL

  • RESTORE_DB_LOG

  • FINISH_RESTORE

database_name

작업이 연결되어 있는 데이터베이스의 이름입니다.

% complete

백분율로 나타낸 작업의 진행률입니다.

duration (mins)

작업에 소요된 시간입니다(분).

lifecycle

작업의 상태입니다. 가능한 상태는 다음과 같습니다.

  • CREATED – rds_backup_database 또는 rds_restore_database를 호출하는 즉시 작업이 생성되고 상태는 CREATED로 설정됩니다.

  • IN_PROGRESS – 백업 또는 복원 작업이 시작된 후 상태가 로 설정됩니다.IN_PROGRESS CREATED에서 IN_PROGRESS로 상태가 변경되려면 최대 5분이 걸릴 수 있습니다.

  • SUCCESS – 백업 또는 복원 작업이 완료된 후 상태가 로 설정됩니다.SUCCESS

  • ERROR – 백업 또는 복원 작업이 실패한 후 상태가 로 설정됩니다.ERROR 오류에 대한 자세한 내용은 task_info 열을 참조하십시오.

  • CANCEL_REQUESTED – rds_cancel_task를 호출하는 즉시 작업의 상태가 CANCEL_REQUESTED로 설정됩니다.

  • CANCELLED – 작업이 성공적으로 취소된 뒤에는 작업 상태가 로 설정됩니다.CANCELLED

task_info

작업에 대한 추가 정보입니다.

데이터베이스를 백업하거나 복원하는 동안 오류가 발생하면 이 열에 오류에 대한 정보가 포함됩니다. 가능한 오류 목록 및 완화 전략은 문제 해결 단원을 참조하십시오.

last_updated

작업 상태를 마지막으로 업데이트한 날짜와 시간입니다. 상태는 5% 진행 후마다 업데이트됩니다.

created_at

작업을 생성한 날짜와 시간입니다.
S3_object_arn 백업 또는 복원 중인 파일의 Amazon S3 접두사 및 이름을 나타내는 ARN입니다.

overwrite_s3_backup_file

백업 작업을 호출할 때 지정된 @overwrite_s3_backup_file 파라미터의 값입니다. 자세한 내용은 데이터베이스 백업 단원을 참조하십시오.
KMS_master_key_arn 암호화(백업용) 및 복호화(복원용)에 사용되는 KMS 키의 ARN입니다.
filepath 기본 백업 및 복원 작업에는 해당되지 않음
overwrite_file 기본 백업 및 복원 작업에는 해당되지 않음