Table.ApplyRefreshPolicy メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 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 では、それ以外の場合は使用できない高度なオプションが有効になります。
- 1 つの 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 では、それ以外の場合は使用できない高度なオプションが有効になります。
- 1 つの API 呼び出し (特に高度なオプション) を使用する場合は、ApplyRefreshPolicy を使用することをお勧めします。
- SaveChanges の呼び出しの前に、モデル内の追加のオーサリング呼び出しと操作を組み合わせる場合は、RequestRefresh + SaveChanges の組み合わせを使用することをお勧めします。