<div id="readability-page-1" class="page"><div><h2>소개</h2>
<p>인덱스를 온라인 옵션으로 생성 시 필요에 따라 일시 정지해 두고 이후 다시 재시작하거나 중지할 수 있는 방법이 SQL Server 2019(또는 Azure SQL)부터 지원되었습니다. SQL Server 2022부터는 Primary Key와 Unique Key 제약 조건을 생할 때도 동일한 기능을 지원합니다, PK와 UQ도 인덱스로 생성되기 때문이죠.</p>
<p><strong>참고 자료</strong></p>
<ul>
<li><a href="https://learn.microsoft.com/ko-kr/sql/relational-databases/security/resumable-add-table-constraints?view=sql-server-ver16?wt.mc_id=DP-MVP-5685" target="_blank" rel="noopener">다시 시작 가능한 테이블 제약조건 추가</a></li>
</ul>

<p>SQL Server 2022 (또는 Azure SQL)에서 기존 테이블에 Primary Key 혹은 UNIQUE Key 생성 시 <strong>ONLINE&nbsp;옵션</strong>을 사용하는 경우 생성 작업이 완료되기 전에 <strong>일시중지</strong>한 뒤 필요할 때 다시 <strong>재시작</strong>하거나 작업을 <strong>취소</strong>할 수 있는 <strong>RESUABLE</strong> 옵션을 추가로 지원합니다.</p>
<p>간단한 개념이니 아래 예제 코드로 충분히 설명이 될겁니다. 시간이 오래 걸리는 작업이 필요해서 개인적으로 만든 DB와 테이블을 사용했습니다, 실제로 돌려보고 싶으시다면 대용량 테이블 하나 만들어서 작업하시기 바랍니다. 간단히 주석도 달았으니 참고하세요. (전반적인 설명은 위 참고 자료의 MS 문서를 보시기 바랍니다)</p>
<div>
<p>USE SalesLab;<br>
GO</p>
<p>— 현재 PK, UQ 확인<br>
EXEC sp_helpconstraint N'dbo.Orders'</p>
<p>/*<br>
1. Resumable PK/UNIQUE 작업<br>
*/<br>
ALTER TABLE dbo.Orders<br>
ADD CONSTRAINT UQ_Orders UNIQUE (OrderKey) — 주의. CL 최대 크기는 900bytes<br>
WITH (ONLINE = ON<br>
, MAXDOP = 8<br>
, RESUMABLE = ON<br>
, MAX_DURATION = 60 MINUTES);<br>
GO — 50 ~ 70s</p>
<p>/*<br>
2. 다른 세션에서, Pause/Resume/Abort 그리고 상태 확인<br>
*/<br>
–상태 확인<br>
SELECT i.percent_complete, i.page_count, *<br>
FROM sys.index_resumable_operations AS i;</p>
<p>— Pause<br>
ALTER INDEX UQ_Orders — 또는 ALL<br>
ON dbo.Orders<br>
PAUSE;<br>
GO</p>
<p>— Resume<br>
ALTER INDEX UQ_Orders — 또는 ALL<br>
ON dbo.Orders<br>
RESUME<br>
WITH<br>
(<br>
MAXDOP = 8 — 이전 수와 동일해야 함<br>
, MAX_DURATION = 60 MINUTES<br>
, WAIT_AT_LOW_PRIORITY (MAX_DURATION = 10, ABORT_AFTER_WAIT = SELF) — NONE/SELF/BLOCKERS<br>
) ;<br>
GO</p>
<p>— Abort<br>
ALTER INDEX UQ_Orders<br>
ON dbo.Orders<br>
ABORT;<br>
GO</p>
</div>

<p><strong>[그림-1]&nbsp;생성 작업 중에 sys.index_resumable_operations 를 수행한 결과</strong></p>
<p>진행율(percent_complete), I/O량(page_count), 상태, 이름, 쿼리, 병렬처리 CPU수(last_max_dop_used) 등의 상태 정보를 실시간으로 확인할 수 있습니다.</p>
<h2><img src="https://visualdb.net/wp-content/uploads/2024/01/SQLServer2022-20-1.png" alt="" width="946" height="45" sizes="(max-width: 946px) 100vw, 946px"></h2>
<h2>정리</h2>
<p>대용량 테이블과 인덱스를 운영하고 있고 인덱스 Rebuild 작업을 위해 서비스 중지시간이 충분하지 않은 경우나 혹은 ONLINE 작업에 방해 요소가 발생할 수 있다면 이러한 옵션을 활용할 수 있겠습니다. 적용하신다면 꼭 사전에 예행연습을 해 보시길 권합니다.</p>

<p>모두 건강하세요.<br>
김정선 드림</p>
</div><div>
			<p><img alt="" src="https://secure.gravatar.com/avatar/9e858557f785e172ec712c13488407cf?s=80&amp;d=mm&amp;r=g" height="80" width="80"></p>			<div>
				<h4><span>Author:</span>&nbsp;Jungsun Kim</h4>
				<p><a href="https://visualdb.net/" rel="author">https://visualdb.net</a></p><p>(주)씨퀄로 대표컨설턴트/이사, 
인프런 지식공유자, 
탈잉 튜터, 
스킬서포트 교육센터 강사, 
Microsoft Data Platform MVP</p>
			</div>
		</div></div>

김정선의 Data 이야기

소개
인덱스를 온라인 옵션으로 생성 시 필요에 따라 일시 정지해 두고 이후 다시 재시작하거나 중지할 수 있는 방법이 SQL Server 2019(또는 Azure SQL)부터 지원되었습니다. SQL Server 2022부터는 Primary Key와 Unique Key 제약 조건을 생할 때도 동일한 기능을 지원합니다, PK와 UQ도 인덱스로 생성되기 때문이죠.
참고 자료
다시 시작 가능한 테이블 제약조건 추가
재시작 가능한 PK/UQ 온라인 생성
SQL Server 2022 (또는 Azure SQL)에서 기존 테이블에 Primary Key 혹은 UNIQUE Key 생성 시 ONLINE 옵션을 사용하는 경우 생성 작업이 완료되기 전에 일시중지한 뒤 필요할 때 다시 재시작하거나 작업을 취소할 수 있는 RESUABLE 옵션을 추가로 지원합니다.
간단한 개념이니 아래 예제 코드로 충분히 설명이 될겁니다. 시간이 오래 걸리는 작업이 필요해서 개인적으로 만든 DB와 테이블을 사용했습니다, 실제로 돌려보고 싶으시다면 대용량 테이블 하나 만들어서 작업하시기 바랍니다. 간단히 주석도 달았으니 참고하세요. (전반적인 설명은 위 참고 자료의 MS 문서를 보시기 바랍니다)
USE SalesLab;
— 현재 PK, UQ 확인
/*
/*
— Pause
— Resume
— Abort
 
[그림-1] 생성 작업 중에 sys.index_resumable_operations 를 수행한 결과
진행율(percent_complete), I/O량(page_count), 상태, 이름, 쿼리, 병렬처리 CPU수(last_max_dop_used) 등의 상태 정보를 실시간으로 확인할 수 있습니다.
정리
대용량 테이블과 인덱스를 운영하고 있고 인덱스 Rebuild 작업을 위해 서비스 중지시간이 충분하지 않은 경우나 혹은 ONLINE 작업에 방해 요소가 발생할 수 있다면 이러한 옵션을 활용할 수 있겠습니다. 적용하신다면 꼭 사전에 예행연습을 해 보시길 권합니다.
 
모두 건강하세요.
김정선 드림

SQL SERVER 2022-20-재시작 가능한 PK와 UQ 온라인 생성

댓글