다음을 통해 공유


Table.ApplyRefreshPolicy 메서드

정의

오버로드

ApplyRefreshPolicy(Boolean, Int32)

사용되는 유효 날짜가 현재 시간을 기반으로 할 때 연결된 새로 고침 정책에 따라 결정되는 테이블의 분할 구성표를 조정합니다.

ApplyRefreshPolicy(DateTime, Boolean, Int32)

테이블과 연결된 새로 고침 정책과 지정된 유효 날짜에 따라 결정되는 테이블의 분할 구성표를 조정합니다.

ApplyRefreshPolicy(Boolean, Int32)

사용되는 유효 날짜가 현재 시간을 기반으로 할 때 연결된 새로 고침 정책에 따라 결정되는 테이블의 분할 구성표를 조정합니다.

public System.Collections.Generic.IReadOnlyList<Microsoft.AnalysisServices.Tabular.ModelOperationResult> ApplyRefreshPolicy (bool refresh = true, int maxParallelism = 0);
member this.ApplyRefreshPolicy : bool * int -> System.Collections.Generic.IReadOnlyList<Microsoft.AnalysisServices.Tabular.ModelOperationResult>
Public Function ApplyRefreshPolicy (Optional refresh As Boolean = true, Optional maxParallelism As Integer = 0) As IReadOnlyList(Of ModelOperationResult)

매개 변수

refresh
Boolean

테이블의 파티션을 새로 고쳐야 하는지 여부를 나타내는 표시입니다. 기본 동작은 새로 고침을 수행하는 것입니다.

maxParallelism
Int32

새로 고침 실행 중 병렬 처리 수준입니다.

반환

프로시저에서 실행된 작업의 결과입니다.

설명

  • ApplyRefreshPolicy의 실행 흐름은 RequestRefresh 호출에 의해 트리거된 흐름과 같으며 Model.SaveChanges를 호출합니다.
  • 실행 흐름에는 다음이 포함됩니다.
    • 유효 날짜를 기준으로 예상되는 분할 체계를 계산합니다.
    • 예상 파티션 구성표를 기존 파티션 집합과 비교하고 필요한 변경 내용을 실행하여 필요한 구성표로 이동합니다(필요에 따라 파티션 삭제, 만들기 및 병합).
    • 새로 만든 파티션과 증분 창의 기존 파티션을 새로 고칩니다.
  • ApplyRefreshPolicy와 RequestRefresh + SaveChanges의 조합 간의 유일한 차이점은 ApplyRefreshPolicy가 그렇지 않으면 사용할 수 없는 고급 옵션을 사용하도록 설정한다는 것입니다.
  • 특히 고급 옵션에서 단일 API 호출을 사용하려는 경우 ApplyRefreshPolicy를 사용하는 것이 좋습니다.
  • SaveChanges를 호출하기 전에 모델의 추가 작성 호출과 작업을 결합하려는 경우 RequestRefresh + SaveChanges의 조합을 사용하는 것이 좋습니다.

적용 대상

ApplyRefreshPolicy(DateTime, Boolean, Int32)

테이블과 연결된 새로 고침 정책과 지정된 유효 날짜에 따라 결정되는 테이블의 분할 구성표를 조정합니다.

public System.Collections.Generic.IReadOnlyList<Microsoft.AnalysisServices.Tabular.ModelOperationResult> ApplyRefreshPolicy (DateTime effectiveDate, bool refresh = true, int maxParallelism = 0);
member this.ApplyRefreshPolicy : DateTime * bool * int -> System.Collections.Generic.IReadOnlyList<Microsoft.AnalysisServices.Tabular.ModelOperationResult>
Public Function ApplyRefreshPolicy (effectiveDate As DateTime, Optional refresh As Boolean = true, Optional maxParallelism As Integer = 0) As IReadOnlyList(Of ModelOperationResult)

매개 변수

effectiveDate
DateTime

분할 체계를 계산할 때 사용되는 유효 날짜입니다.

refresh
Boolean

테이블의 파티션을 새로 고쳐야 하는지 여부를 나타내는 표시입니다. 기본 동작은 새로 고침을 수행하는 것입니다.

maxParallelism
Int32

새로 고침 실행 중 병렬 처리 수준입니다.

반환

프로시저에서 실행된 작업의 결과입니다.

설명

  • ApplyRefreshPolicy의 실행 흐름은 RequestRefresh 호출에 의해 트리거된 흐름과 같으며 Model.SaveChanges를 호출합니다.
  • 실행 흐름에는 다음이 포함됩니다.
    • 유효 날짜를 기준으로 예상되는 분할 체계를 계산합니다.
    • 예상 파티션 구성표를 기존 파티션 집합과 비교하고 필요한 변경 내용을 실행하여 필요한 구성표로 이동합니다(필요에 따라 파티션 삭제, 만들기 및 병합).
    • 새로 만든 파티션과 증분 창의 기존 파티션을 새로 고칩니다.
  • ApplyRefreshPolicy와 RequestRefresh+SaveChanges의 조합 간의 유일한 차이점은 ApplyRefreshPolicy를 사용하면 사용할 수 없는 고급 옵션을 사용할 수 있다는 것입니다.
  • 특히 고급 옵션에서 단일 API 호출을 사용하려는 경우 ApplyRefreshPolicy를 사용하는 것이 좋습니다.
  • SaveChanges를 호출하기 전에 모델의 추가 작성 호출과 작업을 결합하려는 경우 RequestRefresh + SaveChanges의 조합을 사용하는 것이 좋습니다.

적용 대상