sqlmaint 유틸리티

아티클
03/12/2024

적용 대상:SQL Server

sql기본t 유틸리티는하나 이상의 데이터베이스에서 지정된 기본 테넌트 작업 집합을 수행합니다. sql기본t를 사용하여 DBCC 검사 실행하고, 데이터베이스 및 해당 트랜잭션 로그를 백업하고, 통계를 업데이트하고, 인덱스를 다시 작성합니다. 모든 데이터베이스 기본 테넌트 활동은 지정된 텍스트 파일, HTML 파일 또는 전자 메일 계정으로 보낼 수 있는 보고서를 생성합니다. sqlmaint는 이전 버전의 SQL Server로 만든 데이터베이스 유지 관리 계획을 실행합니다. 명령 프롬프트에서 SQL Server 유지 관리 계획을 실행하려면 dtexec 유틸리티를 사용합니다.

Important

이 기능은 이후 버전의 SQL Server에서 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 SQL Server 유지 관리 계획 기능을 사용합니다. 유지 관리 계획에 대한 자세한 내용은 유지 관리 계획을 참조하세요.

구문

  
sqlmaint   
[-?] |  
[  
     [-S server_name[\instance_name]]  
     [-U login_ID [-P password]]  
     {  
          [-D database_name | -PlanName name | -PlanID guid ]  
          [-Rpt text_file]  
          [-To operator_name]  
          [-HtmlRpt html_file [-DelHtmlRpt <time_period>] ]  
          [-RmUnusedSpace threshold_percentfree_percent]  
          [-CkDB | -CkDBNoIdx]  
          [-CkAl | -CkAlNoIdx]  
          [-CkCat]  
          [-UpdOptiStats sample_percent]  
          [-RebldIdx free_space]  
          [-SupportComputedColumn]  
          [-WriteHistory]  
          [  
               {-BkUpDB [backup_path] | -BkUpLog [backup_path] }  
               {-BkUpMedia  
                    {DISK [  
                           [-DelBkUps <time_period>]   
                           [-CrBkSubDir ]   
                           [-UseDefDir ]   
                          ]  
                     | TAPE   
                    }  
               }  
               [-BkUpOnlyIfClean]  
               [-VrfyBackup]  
          ]  
     }  
]  
<time_period> ::=  
number[minutes | hours | days | weeks | months]

인수

매개 변수와 해당 값은 공백으로 구분해야 합니다. 예를 들어 -S와 server_name 사이에 공백이 있어야 합니다.

-?
sql기본t에 대한 구문 다이어그램이 반환되도록 지정합니다. 이 매개 변수는 단독으로 사용해야 합니다.

-Sserver_name[ \instance_name]
Microsoft SQL Server의 대상 인스턴스를 지정합니다. 해당 서버에 있는 SQL Server 데이터베이스 엔진의 기본 인스턴스에 연결하려면 server_name을 지정합니다. 해당 서버에 있는 데이터베이스 엔진의 명명된 인스턴스에 연결하려면 server_name\instance_name을 지정합니다. 서버를 지정하지 않으면 sqlmaint가 로컬 컴퓨터에 있는 데이터베이스 엔진의 기본 인스턴스에 연결됩니다.

-Ulogin_ID
서버에 연결할 때 사용할 로그인 ID를 지정합니다. 이 인수를 제공하지 않으면 sqlmaint에서 Microsoft Windows 인증을 사용하려고 시도합니다. login_ID 특수 문자를 포함하는 경우 큰따옴표(");로 묶어야 합니다. 그렇지 않으면 큰따옴표는 선택 사항입니다.

Important

가능하면 Windows 인증을 사용하세요.

-Ppassword
로그인 ID의 암호를 지정합니다. -U 매개 변수도 제공된 경우에만 유효합니다. 암호에 특수 문자가 포함된 경우 큰따옴표로 묶어야 합니다. 그렇지 않으면 큰따옴표는 선택 사항입니다.

Important

암호가 마스킹되지 않았습니다. 가능하면 Windows 인증을 사용하세요.

-Ddatabase_name
기본 테넌트 작업을 수행할 데이터베이스의 이름을 지정합니다. database_name 에 특수 문자가 포함된 경우 큰따옴표(")로 묶어야 합니다. 그렇지 않은 경우 큰따옴표는 선택 사항입니다.

-PlanName이름
데이터베이스 유지 관리 계획 마법사를 사용하여 정의된 데이터베이스 기본 테넌트 계획의 이름을 지정합니다. 계획에서 sql기본t에서 사용하는 유일한 정보는 계획의 데이터베이스 목록입니다. 다른 sql기본t 매개 변수에 지정한 모든 기본 테넌트 활동은 이 데이터베이스 목록에 적용됩니다.

-PlanIDguid
데이터베이스 유지 관리 계획 마법사를 사용하여 정의된 데이터베이스 기본 테넌트 계획의 GUID(Globally Unique Identifier)를 지정합니다. 계획에서 sql기본t에서 사용하는 유일한 정보는 계획의 데이터베이스 목록입니다. 다른 sql기본t 매개 변수에 지정한 모든 기본 테넌트 활동은 이 데이터베이스 목록에 적용됩니다. 이 인수는 msdb.dbo.sysdbmaintplans의 plan_id 값과 일치해야 합니다.

-Rpttext_file
보고서를 생성할 파일의 전체 경로와 이름을 지정합니다. 이 보고서는 화면에도 생성됩니다. 보고서는 파일 이름에 날짜를 추가하여 버전 정보를 기본. 날짜는 _yyyyMMddhhmm형식으로 파일 이름 끝의 마침표 앞에 생성됩니다. yyyy = year, MM = month, dd = day, hh = hour, mm = minute.

1996년 12월 1일 오전 10시 23분에 유틸리티를 실행하는 경우 text_file 값은 다음과 같습니다.

c:\Program Files\Microsoft SQL Server\Mssql\Backup\AdventureWorks2022_maint.rpt

생성되는 파일 이름은 다음과 같습니다.

c:\Program Files\Microsoft SQL Server\Mssql\Backup\AdventureWorks2022_maint_199612011023.rpt

sqlmaint 에서 원격 서버에 액세스할 때 text_file 에는 전체 UNC(범용 명명 규칙) 파일 이름이 필요합니다.

-tooperator_name
생성된 보고서가 SQL Mail을 통해 전송되는 운영자를 지정합니다.

-HtmlRpthtml_file
HTML 보고서를 생성할 파일의 전체 경로와 이름을 지정합니다. sql기본t는 -Rpt 매개 변수와 마찬가지로 _yyyyMMddhhmm 형식의 문자열을 파일 이름에 추가하여 파일 이름을 생성합니다.

sqlmaint 에서 원격 서버에 액세스할 때 html_file 에는 전체 UNC 파일 이름이 필요합니다.

-DelHtmlRpt<time_period>
보고서 파일을 만든 후 시간 간격이 <time_period>를 초과할 경우 보고서 디렉터리에 있는 HTML 보고서가 삭제되도록 지정합니다. -DelHtmlRpt는 이름이 html_file 매개 변수에서 생성된 패턴에 맞는 파일을 찾습니다. html_file c:\Program Files\Microsoft SQL Server\Mssql\Backup\AdventureWorks2022_기본t.htm 경우 -DelHtmlRpt는기본 이름이 C:\Program Files\Microsoft SQL Server\Mssql\Backup\AdventureWorks2022_기본t*.htm 패턴과 일치하고 지정된< time_period> 이전인 파일을 모두 삭제합니다.

-RmUnusedSpacethreshold_percent free_percent
사용되지 않는 공간을 -D에 지정된 데이터베이스에서 제거되도록 지정합니다. 이 옵션은 자동으로 증가하도록 정의된 데이터베이스에서만 유용합니다. Threshold_percent sql기본t에서 사용하지 않는 데이터 공간을 제거하기 전에 데이터베이스가 도달해야 하는 크기를 메가바이트 단위로 지정합니다. 데이터베이스가 threshold_percent보다 작으면 아무 작업도 수행되지 않습니다. Free_percent 데이터베이스에서 사용하지 않는 공간을 다시 기본 데이터베이스의 최종 크기의 백분율로 지정합니다. 예를 들어 200MB 데이터베이스에 100MB의 데이터가 포함된 경우 free_percent 대해 10을 지정하면 최종 데이터베이스 크기는 110MB가 됩니다. 데이터베이스가 free_percent 데이터베이스의 데이터 양보다 작으면 확장되지 않습니다. 예를 들어 108MB의 데이터베이스에 100MB 데이터가 포함된 경우 free_percent 에 10을 지정하면 데이터베이스가 110MB로 확장되지 않고 108MB로 유지됩니다.

-CkDB-CkDBNoIdx |
-D에 지정된 데이터베이스에서 NOINDEX 옵션이 있는 DBCC CHECKDB 문 또는 DBCC CHECKDB 문을 실행되도록 지정합니다. 자세한 내용은 DBCC CHECKDB를 참조하세요.

sql기본t를 실행할 때 데이터베이스가 사용 중이면 text_file 경고가 기록 됩니다.

-CkAl-CkAlNoIdx |
-D에 지정된 데이터베이스에서 NOINDEX 옵션으로 DBCC CHECKALLOC 문을 실행하도록 지정합니다. 자세한 내용은 DBCC CHECKALLOC(Transact-SQL)를 참조하세요.

-CkCat
DBCC CHECKCATALOG(Transact-SQL) 문이 -D에 지정된 데이터베이스에서 실행되도록 지정합니다. 자세한 내용은 DBCC CHECKCATALOG(Transact-SQL)를 참조하세요.

-UpdOptiStatssample_percent
데이터베이스의 각 테이블에서 다음 문을 실행되도록 지정합니다.

UPDATE STATISTICS table WITH SAMPLE sample_percent PERCENT;

테이블에 계산 열이 포함된 경우에는 -UpdOptiStats 를 사용할 때 -SupportedComputedColumn인수도 지정해야 합니다.

자세한 내용은 UPDATE STATISTICS(Transact-SQL)로 만든 데이터베이스 유지 관리 계획을 실행합니다.

-RebldIdxfree_space
free_space 백분율 값을 채우기 비율의 역으로 사용하여 대상 데이터베이스의 테이블에 대한 인덱스를 다시 작성할 것을 지정합니다. 예를 들어 free_space 백분율이 30이면 사용된 채우기 비율은 70입니다. free_space 백분율 값으로 100을 지정하면 원래 채우기 비율 값으로 인덱스가 다시 작성됩니다.

인덱스가 계산 열에 있을 경우 -RebldIdx 를 사용할 때 -SupportComputedColumn인수도 지정해야 합니다.

-SupportComputedColumn
계산 열에서 sql기본t를 사용하여 DBCC 기본tenance 명령을 실행하려면 지정해야 합니다.

-WriteHistory
sqlmaint에서 수행되는 각 유지 관리 동작에 대한 항목을 msdb.dbo.sysdbmaintplan_history에 만들도록 지정합니다. -PlanName 또는 -PlanID 를 지정할 경우 sysdbmaintplan_history의 항목은 지정된 계획의 ID를 사용합니다. -D 를 지정할 경우 sysdbmaintplan_history의 항목은 계획 ID에 0을 사용하여 생성됩니다.

-BkUpDB [ backup_path] | -BkUpLog [ backup_path ]
백업 동작을 지정합니다. -BkUpDb 는 전체 데이터베이스를 백업합니다. -BkUpLog 는 트랜잭션 로그만 백업합니다.

backup_path 백업의 디렉터리를 지정합니다. -UseDefDir도 지정되고 둘 다 지정된 경우 -UseDefDir에 의해 재정의되는 경우 backup_path 필요하지 않습니다. 백업은 디렉터리 또는 테이프 디바이스 주소(예: \\.\TAPE0)에 배치할 수 있습니다. 데이터베이스 백업 파일 이름은 다음과 같이 자동으로 생성됩니다.

dbname_db_yyyyMMddhhmm.BAK

라는 설치 관리자 실행 파일에 포함됩니다. 여기서

dbname 은 백업 중인 데이터베이스의 이름입니다.
yyyyMMddhhmm은 yyyy = year, MM = month, dd = day, hh = hour 및 mm = minute인 백업 작업의 시간입니다.

트랜잭션 백업의 파일 이름은 비슷한 형식으로 자동으로 생성됩니다.

dbname_log_yyyymmddhhmm.BAK

-BkUpDB 매개 변수를 사용하는 경우 -BkUpMedia 매개 변수를 사용하여 미디어를 지정해야 합니다.

-BkUpMedia
백업의 미디어 유형(DISK 또는 TAPE)을 지정합니다.

디스크
백업 매체가 디스크임을 지정합니다.

-DelBkUps<time_period>
디스크 백업의 경우 백업을 만든 후 시간 간격이 <time_period>를 초과하면 백업 디렉터리에 있는 모든 백업 파일을 삭제하도록 지정합니다.

-CrBkSubDir
디스크 백업의 경우 -UseDefDir도 지정된 경우 [backup_path] 디렉터리 또는 기본 백업 디렉터리에 하위 디렉터리를 만들 것을 지정합니다. 하위 디렉터리의 이름은 -D에 지정된 데이터베이스 이름을 사용하여 생성됩니다. -CrBkSubDir 을 사용하면 backup_path 매개 변수를 변경할 필요 없이 다른 데이터베이스의 모든 백업을 별도의 하위 디렉터리에 쉽게 넣을 수 있습니다.

-UseDefDir
디스크 백업의 경우 기본 백업 디렉터리에 백업 파일을 만들 수 있도록 지정합니다. 둘 다 지정한 경우UseDefDir 이 backup_path 보다 우선 적용됩니다. 기본 Microsoft SQL Server 설정을 사용하는 경우 기본 백업 디렉터리는 C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Backup입니다.

테이프
백업 매체가 테이프임을 지정합니다.

-BkUpOnlyIfClean
지정된 -Ck 검사 데이터에 문제가 없는 경우에만 백업이 수행되도록 지정합니다. 유지 관리 작업은 명령 프롬프트에 표시되는 것과 동일한 순서로 실행됩니다. -BkUpOnlyIfClean을 지정하려는 경우 -BkUpDB-BkUpLog 매개 변수 앞에 -CkDB, -CkDBNoIdx/, -CkAl, -CkAlNoIdx, -CkTxtAl 또는 -CkCat 매개 변수를 지정하거나 검사 문제를 보고하는지 여부에 관계없이 백업이 발생합니다.

-VrfyBackup
RESTORE VERIFYONLY가 완료되면 백업에서 실행되도록 지정합니다.

number[minutes| hours| day weeks| | months]
보고서 또는 백업 파일이 삭제될 만큼 오래되었는지 확인하는 데 사용되는 시간 간격을 지정합니다. number 는 정수와 시간 단위로 공백 없이 구성됩니다. 올바른 예는 다음과 같습니다.

12주
3월
15days

number 만 지정하면 기본적으로 날짜 부분에 weeks가 사용됩니다.

설명

sql기본t 유틸리티는 하나 이상의 데이터베이스에서 기본 테넌트 작업을 수행합니다. -D 를 지정할 경우 지정한 데이터베이스에서만 나머지 스위치에 지정된 작업이 수행됩니다. -PlanName 또는 -PlanID를 지정한 경우 sql기본t에서 지정된 기본 테넌트 계획에서 검색하는 유일한 정보는 계획의 데이터베이스 목록입니다. 다시 기본 sql기본t 매개 변수에 지정된 모든 작업은 계획에서 가져온 목록의 각 데이터베이스에 적용됩니다. sqlmaint 유틸리티는 계획 자체에 정의된 유지 관리 작업을 적용하지는 않습니다.

sqlmaint 유틸리티가 성공적으로 실행되면 0을 반환하고 실패하면 1을 반환합니다. 오류가 보고됩니다.

기본 테넌트 작업이 실패하는 경우
-CkDB, -CkDBNoIdx, -CkAl, -CkAlNoIdx, -CkTxtAl 또는 -CkCat 검사 경우 데이터에 문제가 있습니다.
일반적인 오류가 발생하는 경우

사용 권한

sql기본t 유틸리티는 기본적으로 폴더에 저장 x:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER1\MSSQL\Binn 되는 읽기 및 실행 권한이 sqlmaint.exe있는 모든 Windows 사용자가 실행할 수 있습니다. 또한 -login_ID로 지정된 SQL Server 로그인에는 지정된 동작을 수행하는 데 필요한 SQL Server 사용 권한이 있어야 합니다. Windows 인증을 사용하여 SQL Server에 연결하는 경우 인증된 Windows 사용자에 매핑된 SQL Server 로그인에는 지정된 동작을 수행하는 데 필요한 SQL Server 사용 권한이 있어야 합니다.

예를 들어 -BkUpDB를 사용하려면 BACKUP 문을 실행할 수 있는 권한이 필요합니다. 또한 -UpdOptiStats 인수를 사용하려면 UPDATE STATISTICS 문을 실행할 수 있는 권한이 있어야 합니다. 자세한 내용은 온라인 설명서에서 해당 항목의 "사용 권한" 섹션을 참조하십시오.

예제

A. 데이터베이스에서 DBCC 검사를 수행합니다.

sqlmaint -S MyServer -D AdventureWorks2022 -CkDB -CkAl -CkCat -Rpt C:\MyReports\AdvWks_chk.rpt

B. 계획의 모든 데이터베이스에서 15% 샘플을 사용하여 통계를 업데이트합니다. 또한 110MB에 도달한 데이터베이스를 10% 사용 가능한 공간으로 축소합니다.

sqlmaint -S MyServer -PlanName MyUserDBPlan -UpdOptiStats 15 -RmUnusedSpace 110 10

C. 계획의 모든 데이터베이스를 기본 x:\Program Files\Microsoft SQL Server\MSSQL13 개별 하위 디렉터리에 백업합니다. MSSQLSERVER\MSSQL\Backup 디렉터리. 또한 2주 이전의 모든 백업을 삭제합니다.

sqlmaint -S MyServer -PlanName MyUserDBPlan -BkUpDB -BkUpMedia DISK -UseDefDir -CrBkSubDir -DelBkUps 2weeks

D. 데이터베이스를 기본 x:\Program Files\Microsoft SQL Server\MSSQL13 백업합니다. MSSQLSERVER\MSSQL\Backup 디렉터리.\

sqlmaint -S MyServer -BkUpDB -BkUpMedia DISK -UseDefDir

참고 항목

BACKUP(Transact-SQL)
UPDATE STATISTICS(Transact-SQL)

sqlmaint 유틸리티

구문

인수

설명

사용 권한

예제

A. 데이터베이스에서 DBCC 검사를 수행합니다.

B. 계획의 모든 데이터베이스에서 15% 샘플을 사용하여 통계를 업데이트합니다. 또한 110MB에 도달한 데이터베이스를 10% 사용 가능한 공간으로 축소합니다.

C. 계획의 모든 데이터베이스를 기본 x:\Program Files\Microsoft SQL Server\MSSQL13 개별 하위 디렉터리에 백업합니다. MSSQLSERVER\MSSQL\Backup 디렉터리. 또한 2주 이전의 모든 백업을 삭제합니다.

D. 데이터베이스를 기본 x:\Program Files\Microsoft SQL Server\MSSQL13 백업합니다. MSSQLSERVER\MSSQL\Backup 디렉터리.\

참고 항목

피드백

피드백

추가 리소스