Model.ApplyRefreshPolicies 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
ApplyRefreshPolicies(Boolean, Boolean, Int32) |
調整模型中累加式重新整理資料表的資料分割配置,取決於使用的有效日期是以目前時間為基礎的重新整理原則所決定。 |
ApplyRefreshPolicies(DateTime, Boolean, Boolean, Int32) |
調整模型中累加式重新整理資料表的資料分割配置,取決於與其相關聯的重新整理原則,以及指定的有效日期。 |
ApplyRefreshPolicies(Boolean, Boolean, Int32)
調整模型中累加式重新整理資料表的資料分割配置,取決於使用的有效日期是以目前時間為基礎的重新整理原則所決定。
public System.Collections.Generic.IReadOnlyList<Microsoft.AnalysisServices.Tabular.ModelOperationResult> ApplyRefreshPolicies (bool refresh = true, bool refreshNonPolicyTables = true, int maxParallelism = 0);
member this.ApplyRefreshPolicies : bool * bool * int -> System.Collections.Generic.IReadOnlyList<Microsoft.AnalysisServices.Tabular.ModelOperationResult>
Public Function ApplyRefreshPolicies (Optional refresh As Boolean = true, Optional refreshNonPolicyTables As Boolean = true, Optional maxParallelism As Integer = 0) As IReadOnlyList(Of ModelOperationResult)
參數
- refresh
- Boolean
指出是否應該重新整理模型中累加式重新整理資料表的資料分割;預設行為是執行重新整理。
- refreshNonPolicyTables
- Boolean
指出模型中的一般資料表是否應該重新整理;預設行為是執行重新整理。
- maxParallelism
- Int32
重新整理執行期間的平行處理原則程度。
傳回
程式中執行的作業結果。
備註
- ApplyRefreshPolicies 的執行流程與 RequestRefresh 呼叫所觸發的流程相同,後面接著呼叫 SaveChanges。
- 執行流程包括:
- 根據生效日期計算預期的資料分割配置。
- 比較預期的分割區配置與現有的分割區集,併發出所需的變更以移至預期的配置 [視需要卸載、建立和合併分割區]。
- 重新整理新建立的資料分割,以及累加視窗中的現有分割區。
- ApplyRefreshPolicies 與 RequestRefresh + SaveChanges 組合的唯一差異是 ApplyRefreshPolicies 可啟用無法使用的進階選項。
- 當您想要使用單一 API 呼叫時,建議使用 ApplyRefreshPolicies,特別是在搭配進階選項使用時。
- 當您想要在呼叫 SaveChanges 之前,將作業與模型中的其他撰寫呼叫結合時,建議使用 RequestRefresh + SaveChanges 的組合。
適用於
ApplyRefreshPolicies(DateTime, Boolean, Boolean, Int32)
調整模型中累加式重新整理資料表的資料分割配置,取決於與其相關聯的重新整理原則,以及指定的有效日期。
public System.Collections.Generic.IReadOnlyList<Microsoft.AnalysisServices.Tabular.ModelOperationResult> ApplyRefreshPolicies (DateTime effectiveDate, bool refresh = true, bool refreshNonPolicyTables = true, int maxParallelism = 0);
member this.ApplyRefreshPolicies : DateTime * bool * bool * int -> System.Collections.Generic.IReadOnlyList<Microsoft.AnalysisServices.Tabular.ModelOperationResult>
Public Function ApplyRefreshPolicies (effectiveDate As DateTime, Optional refresh As Boolean = true, Optional refreshNonPolicyTables As Boolean = true, Optional maxParallelism As Integer = 0) As IReadOnlyList(Of ModelOperationResult)
參數
- effectiveDate
- DateTime
計算資料分割配置時所使用的有效日期。
- refresh
- Boolean
指出是否應該重新整理模型中累加式重新整理資料表的資料分割;預設行為是執行重新整理。
- refreshNonPolicyTables
- Boolean
指出模型中的一般資料表是否應該重新整理;預設行為是執行重新整理。
- maxParallelism
- Int32
重新整理執行期間的平行處理原則程度。
傳回
程式中執行的作業結果。
備註
- ApplyRefreshPolicies 的執行流程與 RequestRefresh 呼叫所觸發的流程相同,後面接著呼叫 SaveChanges。
- 執行流程包括:
- 根據生效日期計算預期的資料分割配置。
- 比較預期的分割區配置與現有的分割區集,併發出所需的變更以移至預期的配置 [視需要卸載、建立和合併分割區]。
- 重新整理新建立的資料分割,以及累加視窗中的現有分割區。
- ApplyRefreshPolicies 與 RequestRefresh + SaveChanges 組合的唯一差異是 ApplyRefreshPolicies 可啟用無法使用的進階選項。
- 當您想要使用單一 API 呼叫時,建議使用 ApplyRefreshPolicies,特別是使用進階選項。
- 當您想要在呼叫 SaveChanges 之前,將作業與模型中的其他撰寫呼叫結合時,建議使用 RequestRefresh + SaveChanges 的組合。