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

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer

Ändert die Anforderungsklassifizierungsrichtlinie des Eventhouses.

Berechtigungen

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

Hinweis

Die admin Rolle erbt Cluster AllDatabasesAdmin Berechtigungen.

Syntax

.altercluster policy request_classification SerializedPartialPolicy<| ClassificationFunctionBody

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
SerializedPartialPolicy	string	✔️	Definieren Sie eine serialisierte JSON-Richtlinie. Richtlinieneigenschaften finden Sie unter Anforderungsklassifizierungsrichtlinie.
ClassificationFunctionBody	string	✔️	Der Textkörper der Funktion, die zum Klassifizieren von Anforderungen verwendet werden soll.

Gibt zurück

Der Befehl gibt eine Zeile mit den Details der Eventhouse-Anforderungsklassifizierungsrichtlinie zurück.

Es folgt das Schema der zurückgegebenen Ausgabe:

Name	Typ	Beschreibung
PolicyName	string	Name der Richtlinie. Für die Ereignishausanforderungsklassifizierungsrichtlinie ist dieser Wert "ClusterRequestClassificationPolicy".
EntityName	string	Name der Entität, für die die Richtlinie festgelegt ist. Bei der Eventhouse-Anforderungsklassifizierungsrichtlinie ist dieser Wert eine leere Zeichenfolge.
Policy	string	JSON-Darstellung des Richtlinienobjekts.
ChildEntities	string	Untergeordnete Entitäten, für die diese Richtlinie festgelegt ist. Bei der Eventhouse-Anforderungsklassifizierungsrichtlinie ist dieser Wert eine leere Zeichenfolge.
EntityType	string	Typ der Entität, für die diese Richtlinie festgelegt ist. Bei der Eventhouse-Anforderungsklassifizierungsrichtlinie ist dieser Wert eine leere Zeichenfolge.

Beispiele

Festlegen einer Richtlinie mit mehreren Workloadgruppen

Legen Sie eine Richtlinie fest, die basierend auf der Auswertung mehrerer Bedingungen den Benutzer einer unter vielen verschiedenen Workloadgruppen oder standardmäßig zuweist:

.alter cluster policy request_classification '{"IsEnabled":true}' <|
    case(current_principal_is_member_of('aadgroup=somesecuritygroup@contoso.com'), "First workload group",
         request_properties.current_database == "MyDatabase" and request_properties.current_principal has 'aadapp=', "Second workload group",
         request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query", "Third workload group",
         request_properties.current_application == "KustoQueryRunner", "Fourth workload group",
         request_properties.request_description == "this is a test", "Fifth workload group",
         hourofday(now()) between (17 .. 23), "Sixth workload group",
         "default")

Output

PolicyName	EntityName	Policy	ChildEntities	EntityType
ClusterRequestClassificationPolicy		{"ClassificationProperties": ["current_database", "request_description", "current_application", "current_principal", "request_type"], "IsEnabled": true, "ClassificationFunction": "case(current_principal_is_member_of('aadgroup=somesecuritygroup@contoso.com'), "First workload group", request_properties.current_database == "MyDatabase" und request_properties.current_principal hat 'aadapp=', "Second workload group", request_properties.current_application == "Kusto.Explorer" und request_ properties.request_type == "Query", "Third workload group", request_properties.current_application == "KustoQueryRunner", "Fourth workload group", request_properties.request_description == "this is a test", "Fifth workload group", hourofday(now()) between (17 .. 23), "Sixth workload group", "default")"}

Festlegen einer Richtlinie mit einer einzelnen Workloadgruppe

Legen Sie eine Richtlinie fest, die basierend auf der Auswertung einer zusammengesetzten Bedingung den Benutzer entweder einer benutzerdefinierten Oder einer Standardarbeitsauslastungsgruppe zuweist:

.alter cluster policy request_classification '{"IsEnabled":true}' <|
    iff(request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query",
        "Ad-hoc queries",
        "default")

Output

PolicyName	EntityName	Policy	ChildEntities	EntityType
ClusterRequestClassificationPolicy		{"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": true, "ClassificationFunction": "iff(request_properties.current_application == "Kusto.Explorer" und request_properties.request_type == "Query","Ad-hoc queries","default")"}