MetadataSerializationContext.UpdateModel 메서드

정의

네임스페이스:

Microsoft.AnalysisServices.Tabular.Serialization

어셈블리:

Microsoft.AnalysisServices.Tabular.dll

패키지:

Microsoft.AnalysisServices v19.84.6

오버로드

UpdateModel(Model, Object)	컨텍스트에 저장된 메타데이터 문서의 내용을 기반으로 제공된 Model 업데이트합니다.
UpdateModel(Model, MetadataDeserializationOptions, Object)	컨텍스트에 저장된 메타데이터 문서의 내용을 기반으로 제공된 Model 업데이트합니다.

UpdateModel(Model, Object)

컨텍스트에 저장된 메타데이터 문서의 내용을 기반으로 제공된 Model 업데이트합니다.

public void UpdateModel (Microsoft.AnalysisServices.Tabular.Model model, object context = default);

member this.UpdateModel : Microsoft.AnalysisServices.Tabular.Model * obj -> unit

Public Sub UpdateModel (model As Model, Optional context As Object = Nothing)

매개 변수

model

Model

업데이트할 모델입니다.

context

Object

serialization 작업과 연결될 선택적 사용자 컨텍스트입니다.

예외

ArgumentNullException

지정된 모델은 null 참조(Visual Basic의 경우 Nothing)입니다.

InvalidOperationException

컨텍스트에 로드되는 메타데이터 문서가 없습니다.

설명

이러한 업데이트 작업에서 지원되는 컨텍스트의 문서 내용에는 특정 제한 사항이 있습니다.

• 개체의 특정 속성만 업데이트할 수 없으며, 메타데이터 트리에 포함된 모든 자식 개체뿐만 아니라 전체 개체를 업데이트하는 데만 사용할 수 있습니다.
• 이 작업에서는 데이터베이스 및 모델 개체를 업데이트할 수 없으며 모델의 직접 또는 간접 자식인 메타데이터 개체만 업데이트할 수 있습니다.
• 컨텍스트의 문서가 처리되는 특정 순서를 보장하지 않으며 문서 간에 종속성이 없는지 확인합니다.
• 실패 시 대상 모델이 그대로 유지된다는 보장은 없습니다. 메서드가 실패하고 예외가 발생하면 대상 모델이 부분적으로 업데이트되었을 수 있으며, 실패하고 예외를 트리거한 문서 이전에 이미 처리된 문서를 기반으로 하는 일부 변경 내용이 포함될 수 있습니다.

컨텍스트에서 문서의 메타데이터 콘텐츠를 역직렬화하고 콘텐츠에 따라 모델을 업데이트하면 역직렬화되는 콘텐츠의 스타일과 관련된 예외가 발생할 수 있습니다. 예를 들어 TMDL 콘텐츠의 역직렬화는 문서의 오류에 대해 throw되는 TmdlFormatException 또는 TmdlSerializationException 발생할 수 있습니다.

UpdateModel(Model, MetadataDeserializationOptions, Object)

컨텍스트에 저장된 메타데이터 문서의 내용을 기반으로 제공된 Model 업데이트합니다.

public void UpdateModel (Microsoft.AnalysisServices.Tabular.Model model, Microsoft.AnalysisServices.Tabular.Serialization.MetadataDeserializationOptions options, object context = default);

member this.UpdateModel : Microsoft.AnalysisServices.Tabular.Model * Microsoft.AnalysisServices.Tabular.Serialization.MetadataDeserializationOptions * obj -> unit

Public Sub UpdateModel (model As Model, options As MetadataDeserializationOptions, Optional context As Object = Nothing)

매개 변수

model

Model

업데이트할 모델입니다.

options

MetadataDeserializationOptions

역직렬화 작업에 대한 옵션입니다.

context

Object

serialization 작업과 연결될 선택적 사용자 컨텍스트입니다.

예외

ArgumentNullException

• 지정된 모델은 null 참조(Visual Basic의 경우 Nothing)입니다.
• 지정된 옵션 인스턴스가 null 참조(Visual Basic의 경우 Nothing)입니다.

InvalidOperationException

컨텍스트에 로드되는 메타데이터 문서가 없습니다.

설명

이러한 업데이트 작업에서 지원되는 컨텍스트의 문서 내용에는 특정 제한 사항이 있습니다.

• 개체의 특정 속성만 업데이트할 수 없으며, 메타데이터 트리에 포함된 모든 자식 개체뿐만 아니라 전체 개체를 업데이트하는 데만 사용할 수 있습니다.
• 이 작업에서는 데이터베이스 및 모델 개체를 업데이트할 수 없으며 모델의 직접 또는 간접 자식인 메타데이터 개체만 업데이트할 수 있습니다.
• 컨텍스트의 문서가 처리되는 특정 순서를 보장하지 않으며 문서 간에 종속성이 없는지 확인합니다.
• 실패 시 대상 모델이 그대로 유지된다는 보장은 없습니다. 메서드가 실패하고 예외가 발생하면 대상 모델이 부분적으로 업데이트되었을 수 있으며, 실패하고 예외를 트리거한 문서 이전에 이미 처리된 문서를 기반으로 하는 일부 변경 내용이 포함될 수 있습니다.

컨텍스트에서 문서의 메타데이터 콘텐츠를 역직렬화하고 콘텐츠에 따라 모델을 업데이트하면 역직렬화되는 콘텐츠의 스타일과 관련된 예외가 발생할 수 있습니다. 예를 들어 TMDL 콘텐츠의 역직렬화는 문서의 오류에 대해 throw되는 TmdlFormatException 또는 TmdlSerializationException 발생할 수 있습니다.