데이터 계층 애플리케이션 업그레이드
적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance
데이터 계층 애플리케이션 업그레이드 마법사 또는 Windows PowerShell 스크립트를 사용하여 현재 배포된 DAC(데이터 계층 애플리케이션)의 스키마와 속성을 새 DAC 버전에 정의된 스키마와 속성과 일치하도록 변경할 수 있습니다.
시작하기 전에: DAC 업그레이드 옵션 선택, 제한 사항, 필수 구성 요소, 보안, 권한
DAC를 업그레이드하려면 다음을 사용합니다. 데이터 계층 애플리케이션 업그레이드 마법사, PowerShell
시작하기 전에
DAC 업그레이드는 기존 데이터베이스의 스키마를 새 DAC 버전에 정의된 스키마와 일치하도록 변경하는 전체 업그레이드 프로세스입니다. 새 버전 DAC는 DAC 패키지 파일에 제공됩니다. DAC 패키지를 만드는 방법에 대한 자세한 내용은 데이터 계층 애플리케이션을 참조하세요.
DAC 업그레이드 옵션 선택
현재 위치 업그레이드에는 다음 네 가지 업그레이드 옵션이 있습니다.
데이터 손실 무시 - True이면 일부 작업으로 인해 데이터가 손실되더라도 업그레이드가 진행됩니다. False이면 이러한 작업이 업그레이드를 종료합니다. 예를 들어, 현재 데이터베이스의 테이블이 새로운 DAC의 스키마에 제공되지 않는 경우 True 가 지정되면 테이블이 삭제됩니다. 기본값 설정은 True입니다.
변경 내용 차단 - True인 경우 데이터베이스 스키마가 이전 DAC에 정의된 것과 다르면 업그레이드가 종료됩니다. False인 경우 변경이 감지되어도 업그레이드가 계속됩니다. 기본 설정은 False입니다.
실패 시 롤백 - True이면 업그레이드가 트랜잭션으로 묶이고 오류가 발생하면 롤백이 시도됩니다. False이면 모든 변경 내용이 커밋되고 오류가 발생하면 이전 데이터베이스 백업을 복원해야 할 수 있습니다. 기본 설정은 False입니다.
정책 유효성 검사 건너뛰기 - True이면 DAC 서버 선택 정책이 평가되지 않습니다. False인 경우 정책이 평가되고 유효성 검사 오류가 있으면 업그레이드가 종료됩니다. 기본 설정은 False입니다.
제한 사항
DAC 업그레이드는 SQL Database 또는 SQL Server 2005(9.x) SP4(서비스 팩 4) 이상에서만 수행할 수 있습니다.
필수 조건
업그레이드를 시작하기 전에 전체 데이터베이스 백업을 수행하는 것이 좋습니다. 업그레이드에 오류가 발생하여 모든 변경 내용을 롤백할 수 없는 경우 백업을 복원해야 할 수 있습니다.
업그레이드를 시작하기 전에 DAC 패키지 및 업그레이드 동작의 유효성을 검사하기 위해 취해야 하는 조치는 여러 가지가 있습니다. 이러한 검사를 수행하는 방법에 대한 자세한 내용은 DAC 패키지 유효성 검사를 참조하세요.
출처를 알 수 없거나 신뢰할 수 없는 DAC 패키지는 업그레이드를 제한하는 것이 좋습니다. 이러한 패키지에 포함된 악성 코드가 의도하지 않은 Transact-SQL 코드를 실행하거나 스키마를 수정하여 오류를 발생시킬 수 있습니다. 출처를 알 수 없거나 신뢰할 수 없는 원본의 패키지를 사용하기 전에 먼저 DAC의 압축을 풀고 저장 프로시저 및 다른 사용자 정의 코드와 같은 코드를 검사합니다.
마지막 버전 DAC가 배포된 이후에 현재 데이터베이스를 변경한 경우 일부 변경 내용으로 인해 업그레이드가 성공적으로 완료되지 않거나 업그레이드에서 제거될 수 있습니다. 먼저 데이터베이스의 변경 내용에 대한 보고서를 생성하고 검토해야 합니다.
업그레이드가 수행할 스키마 변경 목록을 생성하고 목록에서 문제가 있는지 검토하는 것이 좋습니다.
DAC 패키지의 애플리케이션 이름이 현재 배포된 DAC의 애플리케이션 이름과 일치해야 합니다. 예를 들어 현재 DAC에 GeneralLedger의 애플리케이션 이름이 있는 경우 애플리케이션 이름이 GeneralLedger인 DAC 패키지를 사용해야만 업그레이드할 수 있습니다.
모든 수정 사항을 기록하는 데 충분한 트랜잭션 로그 공간을 사용할 수 있는지 확인합니다.
보안
보안을 강화하기 위해 SQL Server 인증 로그인은 암호 없이 DAC 패키지에 저장됩니다. 패키지를 배포하거나 업그레이드하면 로그인은 생성된 암호가 있는 비활성화된 로그인으로 만들어집니다. 로그인을 사용하도록 설정하려면 ALTER ANY LOGIN 권한이 있는 로그인을 사용하여 로그인하고 ALTER LOGIN을 사용하여 로그인을 사용하도록 설정하고 사용자에게 전달할 새 암호를 할당합니다. SQL Server에서 암호를 관리하지 않으므로 이 과정은 Windows 인증 로그인에는 필요하지 않습니다.
사용 권한
sysadmin 또는 serveradmin 고정 서버 역할의 멤버를 통하거나 dbcreator 고정 서버 역할에 포함되고 ALTER ANY LOGIN 권한이 있는 로그인을 통해서만 DAC를 업그레이드할 수 있습니다. 로그인은 기존 데이터베이스의 소유자여야 합니다. 내장된 SQL Server 시스템 관리자 계정인 sa도 DAC를 업그레이드할 수 있습니다.
데이터 계층 애플리케이션 업그레이드 마법사 사용
마법사를 사용하여 DAC를 업그레이드하려면
개체 탐색기에서 업그레이드할 DAC가 포함된 데이터베이스를 마우스 오른쪽 단추로 클릭합니다.
작업 옵션을 확장한 다음, 데이터 계층 애플리케이션 업그레이드 옵션을 선택합니다.
마법사 대화 상자를 완료합니다.
소개 페이지
이 페이지에서는 데이터 계층 애플리케이션 업그레이드 마법사의 단계에 대해 설명합니다.
이 페이지를 다시 표시 안 함 - 앞으로 이 페이지가 표시되지 않도록 하려면 이 확인란을 클릭합니다.
다음> - 패키지 선택 페이지로 진행합니다.
취소 - DAC를 업그레이드하지 않고 마법사를 종료합니다.
패키지 선택 페이지
이 페이지를 사용하여 새로운 데이터 계층 애플리케이션의 버전을 포함하는 DAC 패키지를 지정할 수 있습니다. 이 페이지는 두 가지 상태로 전환됩니다.
DAC 패키지 선택
페이지의 초기 상태를 사용하여 배포할 DAC 패키지를 선택합니다. DAC 패키지는 유효한 DAC 패키지 파일이어야 하며 .dacpac 확장명이 있어야 합니다. DAC 패키지의 애플리케이션 이름이 현재 DAC의 애플리케이션 이름과 같아야 합니다.
DAC 패키지 - 새 버전의 데이터 계층 애플리케이션이 포함된 DAC 패키지의 경로와 파일 이름을 지정합니다. 상자 오른쪽에서 찾아보기 단추를 선택하여 DAC 패키지의 위치를 찾아볼 수 있습니다.
애플리케이션 이름 - DAC를 만들거나 데이터베이스에서 추출할 때 할당된 DAC 애플리케이션 이름을 표시하는 읽기 전용 입력란입니다.
버전 - DAC를 만들거나 데이터베이스에서 추출할 때 할당된 버전을 표시하는 읽기 전용 입력란입니다.
설명 - DAC를 만들거나 데이터베이스에서 추출할 때 작성된 설명을 표시하는 읽기 전용 입력란입니다.
< 이전 - 소개 페이지로 돌아갑니다.
다음 > - 선택한 파일이 유효한 DAC 패키지인지 마법사에서 확인하는 동안 진행률 표시줄이 표시됩니다.
취소 - DAC를 업그레이드하지 않고 마법사를 종료합니다.
해당 DAC 패키지 유효성 검사
선택한 파일이 유효한 DAC 패키지인지 마법사에서 확인하는 동안 진행률 표시줄이 표시됩니다. DAC 패키지의 유효성이 확인되면 마법사는 정책 검토 페이지로 진행합니다. 파일이 유효한 DAC 패키지가 아닌 경우 마법사는 DAC 패키지 선택 페이지에서 유지됩니다. 다른 유효한 DAC 패키지를 선택하거나 마법사를 취소하고 새 DAC 패키지를 생성합니다.
DAC의 내용 유효성 검사 - 유효성 검사 프로세스의 현재 상태를 보고하는 진행률 표시줄입니다.
< 이전 - 패키지 선택 페이지의 초기 상태로 돌아갑니다.
다음 > - 패키지 선택 페이지의 최종 버전으로 진행합니다.
취소 - DAC를 배포하지 않고 마법사를 종료합니다.
변경 내용 검색 페이지
이 페이지를 사용하여 msdb
의 DAC 메타데이터에 저장된 스키마 정의와 스키마가 다른 데이터베이스 변경 내용에 대해 마법사가 확인한 결과를 보고할 수 있습니다. 예를 들어 DAC를 배포한 후에 CREATE, ALTER 또는 DROP 문을 사용하여 데이터베이스에 개체를 추가, 변경 또는 제거했을 수 있습니다. 페이지는 먼저 진행률 표시줄을 표시한 다음 분석 결과를 보고합니다.
변경 내용 검색(몇 분 정도 소요될 수 있음) - 마법사가 데이터베이스의 현재 스키마와 DAC 정의의 개체 간의 차이점을 검사할 때 진행률 표시줄을 표시합니다.
변경 내용 검색 결과: - 분석이 완료되었음을 나타내며 아래에 결과가 보고됩니다.
데이터베이스 DatabaseName이 변경되었습니다. - 마법사가 데이터베이스에 정의된 개체와 DAC 정의의 해당 항목 간에 차이를 감지하지 못했습니다.
데이터베이스 DatabaseName이 변경되었습니다. - 마법사가 데이터베이스에 정의된 개체와 DAC 정의의 해당 항목 간에 차이를 검색했습니다.
잠재적인 변경 내용이 손실에도 불구하고 계속 진행 - 현재 데이터베이스의 일부 개체 또는 데이터가 새 데이터베이스에 존재하지 않음을 이해하고 업그레이드를 진행할 의향이 있도록 지정합니다. 변경 보고서를 분석하고 새 데이터베이스에 필요한 개체 또는 데이터를 수동으로 전송하기 위해 수행해야 하는 단계들을 이해한 경우에만 이 단추를 선택해야 합니다. 확실하지 않은 경우 보고서 저장 단추를 선택하여 변경 보고서를 저장한 다음 취소를 선택합니다. 보고서를 분석하고 업그레이드가 완료된 후 필요한 개체와 데이터를 전송하는 방법을 계획한 다음 마법사를 다시 시작합니다.
보고서 저장 - 마법사가 데이터베이스의 개체와 DAC 정의의 해당 항목 간에 검색한 변경 내용에 대한 보고서를 저장하려면 단추를 선택합니다. 그런 다음 보고서를 검토하여 업그레이드가 완료된 후 보고서에 나열된 개체의 일부 또는 전부를 새 데이터베이스에 통합하여 조치를 취해야 하는지 확인할 수 있습니다.
< 이전 - 패키지 선택 페이지로 돌아갑니다.
다음 > - 옵션 페이지로 진행합니다.
취소 - DAC를 배포하지 않고 마법사를 종료합니다.
옵션 페이지
이 페이지를 사용하여 업그레이드에 대한 실패 시 롤백 옵션을 선택합니다.
오류 발생 시 롤백 - 이 옵션을 선택하여 트랜잭션에서 업그레이드를 묶을 수 있으며, 오류가 발생하면 마법사에서 롤백을 시도할 수 있습니다. 옵션에 대한 자세한 내용은 DAC 업그레이드 옵션 선택을 참조하세요.
기본값 복원 - 옵션을 기본값인 false로 반환합니다.
< 이전 - 변경 내용 검색 페이지로 돌아갑니다.
다음 > - 업그레이드 계획 검토 페이지로 진행합니다.
취소 - DAC를 배포하지 않고 마법사를 종료합니다.
업그레이드 계획 페이지 검토
이 페이지를 사용하여 업그레이드 프로세스에서 수행하는 작업을 검토합니다. 업그레이드에 문제가 생기지 않음을 확신하는 경우에만 계속 진행합니다.
다음 작업은 DAC를 업그레이드하는 데 사용됩니다. - 표시된 정보를 검토하여 수행된 작업이 올바른지 확인합니다. 작업 열에는 업그레이드를 수행하기 위해 실행될 Transact-SQL 문과 같은 작업이 표시됩니다. 연결된 작업에서 데이터를 삭제할 수 있는 경우 데이터 손실 열에 경고가 포함됩니다.
새로 고침 – 동작 목록을 새로 고칩니다.
작업 보고서 저장 - 작업 창의 내용을 HTML 파일에 저장합니다.
잠재적인 변경 내용이 손실에도 불구하고 계속 진행 - 현재 데이터베이스의 일부 개체 또는 데이터가 새 데이터베이스에 존재하지 않음을 이해하고 업그레이드를 진행할 의향이 있도록 지정합니다. 변경 보고서를 분석하고 새 데이터베이스에 필요한 개체 또는 데이터를 수동으로 전송하기 위해 수행해야 하는 단계들을 이해한 경우에만 이 단추를 선택해야 합니다. 확실하지 않은 경우에는 동작 보고서 저장 단추를 선택하여 변경 보고서를 저장하고 스크립트 저장 단추로 Transact-SQL 스크립트를 저장한 다음 취소를 선택합니다. 보고서 및 스크립트를 분석하고 업그레이드가 완료된 후 필요한 개체와 데이터를 전송하는 방법을 계획한 다음 마법사를 다시 시작합니다.
스크립트 저장 - 업그레이드를 수행하는 데 사용할 Transact-SQL 문을 텍스트 파일에 저장합니다.
기본값 복원 - 옵션을 기본값인 false로 반환합니다.
< 이전 - 변경 내용 검색 페이지로 돌아갑니다.
다음 > - 요약 페이지로 진행합니다.
취소 - DAC를 배포하지 않고 마법사를 종료합니다.
요약 페이지
이 페이지에서는 DAC를 업그레이드할 때 마법사에서 수행할 동작을 검토할 수 있습니다.
DAC를 업그레이드하는 데 사용되는 설정은 다음과 같습니다. - 표시된 정보를 검토하여 수행된 작업이 올바른지 확인합니다. 이 창에는 업그레이드하도록 선택한 DAC와 새 버전 DAC가 포함된 DAC 패키지가 표시됩니다. 또한 창에는 현재 데이터베이스 버전이 현재 DAC 정의와 같은지 또는 데이터베이스가 변경되었는지 여부도 표시됩니다.
< 이전 - 업그레이드 계획 검토 페이지로 돌아갑니다.
다음 > - DAC를 배포하고 DAC 업그레이드 페이지에 결과를 표시합니다.
취소 - DAC를 배포하지 않고 마법사를 종료합니다.
DAC 업그레이드 페이지
이 페이지에서는 업그레이드 작업의 성공 또는 실패를 보고합니다.
DAC를 업그레이드하고 있습니다. - DAC를 업그레이드하기 위해 수행한 각 동작의 성공 또는 실패를 보고합니다. 정보를 검토하여 각 작업의 성공 또는 실패를 확인합니다. 오류가 발생한 모든 작업에는 결과 열에 링크가 있습니다. 링크를 선택하여 해당 작업에 대한 오류 보고서를 확인합니다.
보고서 저장 - 업그레이드 보고서를 HTML 파일로 저장하려면 이 단추를 선택합니다. 파일은 모든 동작에서 생성된 모든 오류를 비롯하여 각 동작의 상태를 보고합니다. 기본 폴더는 Windows 계정의 Documents 폴더에 있는 SQL Server Management Studio\DAC Packages 폴더입니다.
종료 - 마법사를 종료합니다.
PowerShell 사용
PowerShell 스크립트에서 IncrementalUpgrade() 메서드를 사용하여 DAC를 업그레이드하려면
SMO Server 개체를 만든 다음 업그레이드할 DAC를 포함하는 인스턴스로 설정합니다.
ServerConnection 개체를 열고 동일한 인스턴스에 연결합니다.
System.IO.File을 사용하여 DAC 패키지 파일을 로드합니다.
add_DacActionStarted 및 add_DacActionFinished를 사용하여 DAC 업그레이드 이벤트를 구독합니다.
DacUpgradeOptions을 설정합니다.
IncrementalUpgrade 메서드를 사용하여 DAC를 업그레이드합니다.
DAC 패키지 파일을 읽는 데 사용되는 파일 스트림을 닫습니다.
예제(PowerShell)
다음 예제에서는 MyApplication2017.dacpac 패키지의 새 DAC 버전을 사용하여 데이터베이스 엔진의 기본 인스턴스에서 MyApplication이라는 DAC를 업그레이드합니다.
## Set an SMO Server object to the default instance on the local computer.
CD SQLSERVER:\SQL\localhost\DEFAULT
$srv = get-item .
## Open a Common.ServerConnection to the same instance.
$serverconnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection($srv.ConnectionContext.SqlConnectionObject)
$serverconnection.Connect()
$dacstore = New-Object Microsoft.SqlServer.Management.Dac.DacStore($serverconnection)
## Load the DAC package file.
$dacpacPath = "C:\MyDACs\MyApplication2017.dacpac"
$fileStream = [System.IO.File]::Open($dacpacPath,[System.IO.FileMode]::OpenOrCreate)
$dacType = [Microsoft.SqlServer.Management.Dac.DacType]::Load($fileStream)
## Subscribe to the DAC upgrade events.
$dacstore.add_DacActionStarted({Write-Host `n`nStarting at $(get-date) :: $_.Description})
$dacstore.add_DacActionFinished({Write-Host Completed at $(get-date) :: $_.Description})
## Upgrade the DAC and close the package.
$dacName = "MyApplication"
## Set the upgrade options.
$upgradeProperties = New-Object Microsoft.SqlServer.Management.Dac.DacUpgradeOptions
$upgradeProperties.blockonchanges = $true
$upgradeProperties.ignoredataloss = $false
$upgradeProperties.rollbackonfailure = $true
$ upgradeProperties.skippolicyvalidation = $false
## Upgrade the DAC
$dacstore.IncrementalUpgrade($dacName, $dacType, $upgradeProperties)
## Close the package file.
$fileStream.Close()