sys.sp_클린up_temporal_history(Transact-SQL)

적용 대상:Azure SQL DatabaseAzure SQL Managed Instance

단일 트랜잭션 내에서 구성된 HISTORY_RETENTION PERIOD와 일치하는 임시 기록 테이블에서 모든 행을 제거합니다.

Transact-SQL 구문 표기 규칙

구문

sp_cleanup_temporal_history
    [ @schema_name = ] N'schema_name'
    , [ @table_name = ] N'table_name'
    [ , [ @row_count = ] @row_count_var [ OUTPUT ] ]

인수

[ @schema_name = ] N'schema_name'

보존 클린up이 호출되는 temporal 테이블의 이름입니다.

[ @table_name = ] N'table_name'

현재 temporal 테이블이 속한 스키마의 이름입니다.

[ @row_count = ] @row_count_var [ 출력 ]

삭제된 행 수를 반환하는 출력 매개 변수입니다. 기록 테이블에 클러스터형 columnstore 인덱스가 있으면 이 매개 변수가 반환됩니다 0.

설명

이 저장 프로시저는 유한 보존 기간이 지정된 임시 테이블에만 사용할 수 있습니다. 기록 테이블에서 모든 오래된 행을 즉시 클린 하는 경우에만 이 저장 프로시저를 사용합니다.

sp_cleanup_temporal_history 는 동일한 트랜잭션 내의 모든 적격 행을 삭제하므로 데이터베이스 로그 및 I/O 하위 시스템에 부정적인 영향을 줄 수 있습니다.

일반적으로 일반 워크로드 및 데이터베이스에 미치는 영향을 최소화하면서 오래된 행을 제거하는 클린up에 대한 내부 백그라운드 작업을 사용하는 것이 좋습니다.

사용 권한

db_owner 권한이 필요합니다.

예제

DECLARE @rowcnt INT;

EXEC sys.sp_cleanup_temporal_history 'dbo', 'Department', @rowcnt OUTPUT;

SELECT @rowcnt;