Befehl „.alter cluster policy“ für „query_weak_consistency“

Artikel
11/23/2024

Gilt für:✅Azure Data Explorer

Legt die Abfragerichtlinie für schwache Konsistenz des Clusters fest, überschreibt die aktuelle Richtlinie und gibt dann die aktualisierte Richtlinie zurück. Die aktualisierte Richtlinie kann später mithilfe des Befehls "Anzeigen" angezeigt werden. Wenn sie nicht geändert wird, gilt die Standardrichtlinie .

Berechtigungen

Sie müssen über AllDatabasesAdmin-Berechtigungen verfügen, um diesen Befehl auszuführen.

Syntax

.altercluster policy query_weak_consistency PolicyObject

.alter-mergecluster policy query_weak_consistency PolicyObject

Hinweis

Bei .alter einer nicht angegebenen Eigenschaft wird die Standardeinstellung festgelegt. Bei .alter-merge, werden nur die von Ihnen angegebenen Eigenschaften geändert, während der Rest unverändert bleibt.

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
PolicyObject	`string`	✔️	Ein serialisiertes JSON-Richtlinienobjekt. Informationen zu den Richtlinieneigenschaften finden Sie in der Abfragerichtlinie mit schwacher Konsistenz.

Gibt zurück

JSON-Serialisierung des aktualisierten Abfrageobjekts für schwache Konsistenzrichtlinien

Beispiele

Ändern

alter Befehl:

.alter cluster policy query_weak_consistency ```{
   "PercentageOfNodes": 10,
   "MinimumNumberOfNodes": 2,
   "MaximumNumberOfNodes": 20,
   "SuperSlackerNumberOfNodesThreshold": -1,
   "EnableMetadataPrefetch": false,
   "MaximumLagAllowedInMinutes": 10,
   "RefreshPeriodInSeconds": 300
   }```

Output

PolicyName	EntityName	Policy	ChildEntities	EntityType
QueryWeakConsistencyPolicy		{"PercentageOfNodes": 10, "MinimumNumberOfNodes": 2, "MaximumNumberOfNodes": 20, "SuperSlackerNumberOfNodesThreshold": -1, "EnableMetadataPrefetch": false, "MaximumLagAllowedInMinutes": 10, "RefreshPeriodInSeconds": 300}		Cluster

Für die Demonstration der alter-mergeRichtlinie wird davon ausgegangen, dass vor dem Ausführen des Befehls die folgende Richtlinie festgelegt ist:

{
  "PercentageOfNodes": 20,
  "MinimumNumberOfNodes": 10,
  "MaximumNumberOfNodes": 100, 
  "SuperSlackerNumberOfNodesThreshold": -1,
  "EnableMetadataPrefetch": false,
  "MaximumLagAllowedInMinutes": 5,
  "RefreshPeriodInSeconds": 30
}

Alter-Merge

alter-merge Befehl:

.alter-merge cluster policy query_weak_consistency @'{"PercentageOfNodes": 30, "MaximumLagAllowedInMinutes": 15}'

Output

PolicyName	EntityName	Policy	ChildEntities	EntityType
QueryWeakConsistencyPolicy		{"PercentageOfNodes": 30, "MinimumNumberOfNodes": 10, "MaximumNumberOfNodes": 100, "SuperSlackerNumberOfNodesThreshold": -1, "EnableMetadataPrefetch": false, "MaximumLagAllowedInMinutes": 15, "RefreshPeriodInSeconds": 30}		Cluster

Wie zu sehen ist, werden nur PercentageOfNodes und MaximumLagAllowedInMinutes geändert (wenn der alter Befehl stattdessen verwendet wurde, werden die übrigen Eigenschaften ebenfalls geändert und auf ihre Standardwerte festgelegt).

Freigeben über