Condividi tramite


Model.ApplyRefreshPolicies Metodo

Definizione

Overload

ApplyRefreshPolicies(Boolean, Boolean, Int32)

Modifica dello schema di partizionamento delle tabelle di aggiornamento incrementale nel modello, determinato dai criteri di aggiornamento associati quando la data effettiva utilizzata è basata sull'ora corrente.

ApplyRefreshPolicies(DateTime, Boolean, Boolean, Int32)

Modifica dello schema di partizionamento delle tabelle di aggiornamento incrementale nel modello, determinato dai criteri di aggiornamento associati e dalla data di validità specificata.

ApplyRefreshPolicies(Boolean, Boolean, Int32)

Modifica dello schema di partizionamento delle tabelle di aggiornamento incrementale nel modello, determinato dai criteri di aggiornamento associati quando la data effettiva utilizzata è basata sull'ora corrente.

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)

Parametri

refresh
Boolean

Indicazione se le partizioni delle tabelle di aggiornamento incrementale nel modello devono essere aggiornate o meno; il comportamento predefinito consiste nell'eseguire l'aggiornamento.

refreshNonPolicyTables
Boolean

Indica se le tabelle regolari nel modello devono essere aggiornate o meno; il comportamento predefinito consiste nell'eseguire l'aggiornamento.

maxParallelism
Int32

Grado di parallelismo durante l'esecuzione dell'aggiornamento.

Restituisce

Risultati delle operazioni eseguite nella procedura.

Commenti

  • Il flusso di esecuzione di ApplyRefreshPolicies corrisponde al flusso attivato da una chiamata a RequestRefresh, seguito da una chiamata a SaveChanges.
  • Il flusso di esecuzione include:
    • Calcolo dello schema di partizionamento previsto in base alla data di validità.
    • Confronto tra lo schema di partizionamento previsto e il set esistente di partizioni ed eseguire le modifiche necessarie per passare allo schema previsto [eliminazione, creazione e unione di partizioni in base alle esigenze].
    • Aggiornare le partizioni appena create e le partizioni esistenti nella finestra incrementale.
  • L'unica differenza tra ApplyRefreshPolicies e la combinazione di RequestRefresh + SaveChanges è ApplyRefreshPolicies abilita opzioni avanzate non disponibili in caso contrario.
  • È consigliabile usare ApplyRefreshPolicies quando si vuole usare una singola chiamata API, soprattutto se usata con opzioni avanzate.
  • È consigliabile usare la combinazione di RequestRefresh + SaveChanges quando si desidera combinare l'operazione con chiamate di creazione aggiuntive nel modello prima della chiamata a SaveChanges.

Si applica a

ApplyRefreshPolicies(DateTime, Boolean, Boolean, Int32)

Modifica dello schema di partizionamento delle tabelle di aggiornamento incrementale nel modello, determinato dai criteri di aggiornamento associati e dalla data di validità specificata.

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)

Parametri

effectiveDate
DateTime

Data di validità utilizzata per il calcolo dello schema di partizionamento.

refresh
Boolean

Indicazione se le partizioni delle tabelle di aggiornamento incrementale nel modello devono essere aggiornate o meno; il comportamento predefinito consiste nell'eseguire l'aggiornamento.

refreshNonPolicyTables
Boolean

Indica se le tabelle regolari nel modello devono essere aggiornate o meno; il comportamento predefinito consiste nell'eseguire l'aggiornamento.

maxParallelism
Int32

Grado di parallelismo durante l'esecuzione dell'aggiornamento.

Restituisce

Risultati delle operazioni eseguite nella procedura.

Commenti

  • Il flusso di esecuzione di ApplyRefreshPolicies corrisponde al flusso attivato da una chiamata a RequestRefresh, seguito da una chiamata a SaveChanges.
  • Il flusso di esecuzione include:
    • Calcolo dello schema di partizionamento previsto in base alla data di validità.
    • Confronto tra lo schema di partizionamento previsto e il set esistente di partizioni ed eseguire le modifiche necessarie per passare allo schema previsto [eliminazione, creazione e unione di partizioni in base alle esigenze].
    • Aggiornare le partizioni appena create e le partizioni esistenti nella finestra incrementale.
  • L'unica differenza tra ApplyRefreshPolicies e la combinazione di RequestRefresh + SaveChanges è ApplyRefreshPolicies abilita opzioni avanzate non disponibili in caso contrario.
  • È consigliabile usare ApplyRefreshPolicies quando si vuole usare una singola chiamata API, in particolare con opzioni avanzate.
  • È consigliabile usare la combinazione di RequestRefresh + SaveChanges quando si desidera combinare l'operazione con chiamate di creazione aggiuntive nel modello prima della chiamata a SaveChanges.

Si applica a