Share via


Table.ApplyRefreshPolicy Methode

Definition

Überlädt

ApplyRefreshPolicy(Boolean, Int32)

Anpassen des Partitionierungsschemas der Tabelle, das durch die aktualisierungsrichtlinie bestimmt wird, die ihr zugeordnet ist, wenn das verwendete Gültigkeitsdatum auf der aktuellen Uhrzeit basiert.

ApplyRefreshPolicy(DateTime, Boolean, Int32)

Anpassen des Partitionierungsschemas der Tabelle, das durch die ihr zugeordnete aktualisierungsrichtlinie und das angegebene Gültigkeitsdatum bestimmt wird.

ApplyRefreshPolicy(Boolean, Int32)

Anpassen des Partitionierungsschemas der Tabelle, das durch die aktualisierungsrichtlinie bestimmt wird, die ihr zugeordnet ist, wenn das verwendete Gültigkeitsdatum auf der aktuellen Uhrzeit basiert.

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)

Parameter

refresh
Boolean

Ein Hinweis, ob Partitionen der Tabelle aktualisiert werden sollen oder nicht; Das Standardverhalten besteht darin, die Aktualisierung zu durchführen.

maxParallelism
Int32

Der Grad der Parallelität während der Aktualisierungsausführung.

Gibt zurück

Die Ergebnisse der Vorgänge, die in der Prozedur ausgeführt wurden.

Hinweise

  • Der Ausführungsablauf von ApplyRefreshPolicy ist identisch mit dem Flow, der durch einen Aufruf von RequestRefresh gefolgt von einem Aufruf von Model.SaveChanges ausgelöst wird.
  • Der Ausführungsablauf umfasst Folgendes:
    • Berechnen des erwarteten Partitionierungsschemas basierend auf dem Datum des Inkrafttretens.
    • Vergleichen Sie das erwartete Partitionierungsschema mit dem vorhandenen Satz von Partitionen und geben Sie die erforderlichen Änderungen aus, um zum erwarteten Schema zu wechseln [Löschen, Erstellen und Zusammenführen von Partitionen nach Bedarf].
    • Aktualisieren Sie die neu erstellten Partitionen sowie die vorhandenen Partitionen im inkrementellen Fenster.
  • Der einzige Unterschied zwischen applyRefreshPolicy und der Kombination von RequestRefresh + SaveChanges ist, dass ApplyRefreshPolicy erweiterte Optionen aktiviert, die andernfalls nicht verfügbar sind.
  • Es wird empfohlen, ApplyRefreshPolicy zu verwenden, wenn Sie einen einzelnen API-Aufruf verwenden möchten, insbesondere bei erweiterten Optionen.
  • Es wird empfohlen, die Kombination von RequestRefresh + SaveChanges zu verwenden, wenn Sie den Vorgang vor dem Aufruf von SaveChanges mit zusätzlichen Erstellungsaufrufen im Modell kombinieren möchten.

Gilt für:

ApplyRefreshPolicy(DateTime, Boolean, Int32)

Anpassen des Partitionierungsschemas der Tabelle, das durch die ihr zugeordnete aktualisierungsrichtlinie und das angegebene Gültigkeitsdatum bestimmt wird.

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)

Parameter

effectiveDate
DateTime

Das Effektive Datum, das bei der Berechnung des Partitionierungsschemas verwendet wird.

refresh
Boolean

Ein Hinweis, ob Partitionen der Tabelle aktualisiert werden sollen oder nicht; Das Standardverhalten besteht darin, die Aktualisierung zu durchführen.

maxParallelism
Int32

Der Grad der Parallelität während der Aktualisierungsausführung.

Gibt zurück

Die Ergebnisse der Vorgänge, die in der Prozedur ausgeführt wurden.

Hinweise

  • Der Ausführungsablauf von ApplyRefreshPolicy ist identisch mit dem Flow, der durch einen Aufruf von RequestRefresh gefolgt von einem Aufruf von Model.SaveChanges ausgelöst wird.
  • Der Ausführungsablauf umfasst Folgendes:
    • Berechnen des erwarteten Partitionierungsschemas basierend auf dem Datum des Inkrafttretens.
    • Vergleichen Sie das erwartete Partitionierungsschema mit dem vorhandenen Satz von Partitionen und geben Sie die erforderlichen Änderungen aus, um zum erwarteten Schema zu wechseln [Löschen, Erstellen und Zusammenführen von Partitionen nach Bedarf].
    • Aktualisieren Sie die neu erstellten Partitionen sowie die vorhandenen Partitionen im inkrementellen Fenster.
  • Der einzige Unterschied zwischen applyRefreshPolicy und der Kombination von RequestRefresh+SaveChanges ist, dass ApplyRefreshPolicy erweiterte Optionen aktiviert, die andernfalls nicht verfügbar sind.
  • Es wird empfohlen, ApplyRefreshPolicy zu verwenden, wenn Sie einen einzelnen API-Aufruf verwenden möchten, insbesondere bei erweiterten Optionen.
  • Es wird empfohlen, die Kombination von RequestRefresh + SaveChanges zu verwenden, wenn Sie den Vorgang vor dem Aufruf von SaveChanges mit zusätzlichen Erstellungsaufrufen im Modell kombinieren möchten.

Gilt für: