Dela via


.alter cluster policy request_classification command

Gäller för: ✅Microsoft FabricAzure Data Explorer

Ändrar klustrets policy för klassificering av begäranden.

Ändrar Eventhouses policy för klassificering av begäranden.

Behörigheter

Du måste ha behörigheten Cluster AllDatabasesAdmin för att kunna köra det här kommandot.

Not

Rollen admin ärver Cluster AllDatabasesAdmin behörigheter.

Syntax

.alter cluster policy request_classification SerializedPartialPolicy<|ClassificationFunctionBody

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Krävs Beskrivning
SerializedPartialPolicy string ✔️ Definiera en serialiserad JSON-princip. Information om principegenskaper finns i begärandeklassificeringsprincip.
ClassificationFunctionBody string ✔️ Brödtexten för funktionen som ska användas för att klassificera begäranden.

Returnerar

Kommandot returnerar en rad som visar information om klassificeringsprincipen för klusterbegäran.

Kommandot returnerar en rad som visar information om klassificeringsprincipen för Eventhouse-begäranden.

Följande är schemat för de utdata som returneras:

Namn Typ Beskrivning
PolicyName string Namnet på principen. För klassificeringsprincipen för klusterbegäran är det här värdet ClusterRequestClassificationPolicy.
EntityName string Namnet på den entitet som principen har angetts för. För klassificeringsprincip för klusterbegäran är det här värdet en tom sträng.
Politik string JSON-representation av principobjektet.
Underordnadeentiteter string Underordnade entiteter som den här principen har angetts för. För klassificeringsprincip för klusterbegäran är det här värdet en tom sträng.
EntityType string Typ av entitet som den här principen har angetts för. För klassificeringsprincip för klusterbegäran är det här värdet en tom sträng.
Namn Typ Beskrivning
PolicyName string Namnet på principen. För klassificeringsprincipen för Eventhouse-begäranden är det här värdet ClusterRequestClassificationPolicy.
EntityName string Namnet på den entitet som principen har angetts för. För Klassificeringsprincip för Eventhouse-begäranden är det här värdet en tom sträng.
Politik string JSON-representation av principobjektet.
Underordnadeentiteter string Underordnade entiteter som den här principen har angetts för. För Klassificeringsprincip för Eventhouse-begäranden är det här värdet en tom sträng.
EntityType string Typ av entitet som den här principen har angetts för. För Klassificeringsprincip för Eventhouse-begäranden är det här värdet en tom sträng.

Exempel

Ange en princip med flera arbetsbelastningsgrupper

Ange en princip som, baserat på utvärderingen av flera villkor, tilldelar användaren till en bland många olika arbetsbelastningsgrupper eller till standard:

.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")

utdata

PolicyName EntityName Politik Underordnadeentiteter 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" och request_properties.current_principal har 'aadapp=', "Second workload group", request_properties.current_application == "Kusto.Explorer" och 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")"}

Ange en princip med en enskild arbetsbelastningsgrupp

Ange en princip som, baserat på utvärderingen av ett sammansatt villkor, tilldelar användaren till antingen en anpassad eller till standardarbetsbelastningsgrupp:

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

utdata

PolicyName EntityName Politik Underordnadeentiteter EntityType
ClusterRequestClassificationPolicy {"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": true, "ClassificationFunction": "iff(request_properties.current_application == "Kusto.Explorer" och request_properties.request_type == "Query","Ad-hoc querys","default")"}