DacPackageExtensions.UpdateModel 메서드
현재 모델을 새 모델로 교체하여 DacPackage의 모델을 업데이트합니다. 업데이트하기 전에 모델의 유효성이 검사되며 오류가 발생하는 경우 DacServicesException이 throw됩니다. 호출자가 경고와 오류를 차단하려는 경우 Validate()를 호출하고 반환되는 메시지에 오류 또는 경고가 포함되어 있는지 확인하여 모델의 유효성을 검사해야 합니다. 참고: 모델만 교체됩니다. 리팩터링 로그, 배포 전 스크립트, 배포 후 스크립트 및 참가자 아티팩트와 같은 다른 모든 아티팩트는 변경되지 않습니다. 이러한 아티팩트가 업데이트된 모델에 더 이상 존재하지 않는 요소를 사용하는 경우 배포가 실패할 수 있습니다. 호출자는 이러한 아티팩트가 새 모델과 일치하도록 해야 합니다. Package API를 사용하여 리팩터링 로그 및 스크립트와 같은 다른 아티팩트를 업데이트하고 이러한 아티팩트를 업데이트된 모델과 일치하도록 유지할 수 있습니다. 이러한 아티팩트는 패키지 파트로 저장되며 해당 URI로 식별됩니다. 패키지 파트는 GetParts()를 사용하여 검사할 수 있습니다. 패키지 파트 업데이트에 대한 자세한 내용은Package API를 참조하십시오.
네임스페이스: Microsoft.SqlServer.Dac
어셈블리: Microsoft.SqlServer.Dac.Extensions(Microsoft.SqlServer.Dac.Extensions.dll)
구문
‘선언
<ExtensionAttribute> _
Public Shared Sub UpdateModel ( _
dacPackage As DacPackage, _
newModel As TSqlModel, _
packageMetadata As PackageMetadata _
)
‘사용 방법
Dim dacPackage As DacPackage
Dim newModel As TSqlModel
Dim packageMetadata As PackageMetadata
dacPackage.UpdateModel(newModel, _
packageMetadata)
public static void UpdateModel(
this DacPackage dacPackage,
TSqlModel newModel,
PackageMetadata packageMetadata
)
[ExtensionAttribute]
public:
static void UpdateModel(
DacPackage^ dacPackage,
TSqlModel^ newModel,
PackageMetadata^ packageMetadata
)
static member UpdateModel :
dacPackage:DacPackage *
newModel:TSqlModel *
packageMetadata:PackageMetadata -> unit
public static function UpdateModel(
dacPackage : DacPackage,
newModel : TSqlModel,
packageMetadata : PackageMetadata
)
매개 변수
- dacPackage
유형: Microsoft.SqlServer.Dac.DacPackage
업데이트할 DacPackage
- newModel
유형: Microsoft.SqlServer.Dac.Model.TSqlModel
패키지에 저장할 모델을 나타내는 TSqlModel입니다.
- packageMetadata
유형: Microsoft.SqlServer.Dac.PackageMetadata
DacPackage에 사용할 이름, 버전 및 설명을 나타내는 PackageMetadata이며, 패키지 정보가 동일하게 유지되어야 하는 경우 null입니다.
사용법 정보
Visual Basic 및 C#에서는 이 메서드를 DacPackage 유형의 모든 개체에 대한 인스턴스 메서드로 호출할 수 있습니다. 인스턴스 메서드 구문을 사용하여 이 메서드를 호출하는 경우 첫 번째 매개 변수를 생략합니다. 자세한 내용은 b8020aae-374d-46a9-bcb7-8cc2390b93b6 또는 175ce3ff-9bbf-4e64-8421-faeb81a0bb51을(를) 참조하십시오.
예외
예외 | 조건 |
---|---|
DacServicesException | DacPackage에 데이터가 들어 있는 경우 |
DacServicesException | 패키지에 모델을 저장하는 중에 오류(모델의 유효성을 검사하는 오류 포함)가 발생하는 경우 |
DacServicesException | ReadWrite로 dacPackage가 로드되지 않은 경우 |
ArgumentNullException | dacPackage 또는 newModel 매개 변수가 null인 경우 |