xp_sqlmaint(Transact-SQL)

적용 대상: SQL Server

sqlmaint 옵션(스위치라고도 함)이 포함된 문자열을 사용하여 sqlmaint 유틸리티를 호출합니다. sqlmaint 유틸리티는 하나 이상의 데이터베이스에서 유지 관리 작업 집합을 수행합니다.

참고 항목

SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요.

Transact-SQL 구문 표기 규칙

구문

xp_sqlmaint 'switch_string'

인수

'switch_string'

sqlmaint 유틸리티 스위치를 포함하는 문자열입니다. 스위치와 해당 값은 공백으로 구분해야 합니다.

스위치가 -? 유효 xp_sqlmaint하지 않습니다.

반환 코드 값

없음 sqlmaint 유틸리티가 실패하면 오류를 반환합니다.

설명

SQL Server 인증 -U "<login_id>" 을 사용하여 로그온한 사용자가 이 프로시저를 호출하는 경우 실행 전에 switch_string 앞에 스위치와 -P "<password>" 스위치가 추가됩니다. 사용자가 Windows 인증을 사용하여 로그온한 경우 sqlmaint를 변경하지 않고 switch_string 전달됩니다.

사용 권한

sysadmin 고정 서버 역할의 멤버 자격이 필요하거나 이 저장 프로시저에 대한 권한을 직접 실행해야 합니다.

예제

다음 예제 xp_sqlmaint 에서는 sqlmaint를 호출하여 무결성 검사를 수행하고, 보고서 파일을 만들고, 업데이트msdb.dbo.sysdbmaintplan_history합니다.

EXEC xp_sqlmaint '-D AdventureWorks2022 -PlanID 02A52657-D546-11D1-9D8A-00A0C9054212
   -Rpt "C:\Program Files\Microsoft SQL Server\MSSQL\LOG\DBMaintPlan2.txt" -WriteHistory -CkDB -CkAl';

결과 집합은 다음과 같습니다.

The command(s) executed successfully.

관련 콘텐츠

• sqlmaint 유틸리티
• 시스템 저장 프로시저(Transact-SQL)