Beleid voor aanvraagclassificatie

Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer-

Het classificatieproces wijst binnenkomende aanvragen toe aan een workloadgroep, op basis van de kenmerken van de aanvragen. Pas de classificatielogica aan door de gebruiker gedefinieerde functie te schrijven als onderdeel van een aanvraagclassificatiebeleid op eventhouse-niveau.

Als er geen beleid voor ingeschakelde aanvraagclassificatie is, worden alle aanvragen geclassificeerd in de default workloadgroep.

Beleidsobject

Het beleid heeft de volgende eigenschappen:

• IsEnabled: bool - Geeft aan of het beleid is ingeschakeld of niet.
• ClassificationFunction: string : de hoofdtekst van de functie die moet worden gebruikt voor het classificeren van aanvragen.

Classificatiefunctie

De classificatie van binnenkomende aanvragen is gebaseerd op een door de gebruiker gedefinieerde functie. De resultaten van de functie worden gebruikt om aanvragen te classificeren in bestaande workloadgroepen.

De door de gebruiker gedefinieerde functie heeft de volgende kenmerken en gedragingen:

• Als IsEnabled is ingesteld op true in het beleid, wordt de door de gebruiker gedefinieerde functie geëvalueerd voor elke nieuwe aanvraag.
• De door de gebruiker gedefinieerde functie geeft de context van de workloadgroep voor de aanvraag voor de volledige levensduur van de aanvraag.
• De aanvraag krijgt de context van de default workloadgroep in de volgende situaties:
  • De door de gebruiker gedefinieerde functie retourneert een lege tekenreeks, defaultof de naam van een niet-bestaande workloadgroep.
  • De functie mislukt om welke reden dan ook.
• Op elk gewenst moment kan slechts één door de gebruiker gedefinieerde functie worden aangewezen.

Belangrijk

De functie voor aanvraagclassificatie wordt geëvalueerd voor elke aanvraag die wordt uitgevoerd op eventhouse. Het wordt aanbevolen om het zo licht mogelijk te houden en er geen zware berekeningen in op te nemen. Vermijd bijvoorbeeld dat u veel reguliere expressies moet evalueren als onderdeel van de uitvoering ervan.

Vereisten en beperkingen

Een classificatiefunctie:

• Moet één scalaire waarde van het type stringretourneren. Dit is de naam van de workloadgroep waaraan de aanvraag moet worden toegewezen.
• Mag niet verwijzen naar een andere entiteit (database, tabel of functie).
  • Het is mogelijk dat de volgende functies en operators niet worden gebruikt:
    • cluster()
    • database()
    • table()
    • external_table()
    • externaldata
• Heeft toegang tot een speciaal dynamic symbool, een eigenschappentas met de naam request_properties, met de volgende eigenschappen:

Naam	Type	Beschrijving	Voorbeelden
current_database	string	De naam van de aanvraagdatabase.	"MyDatabase"
current_application	string	De naam van de toepassing die de aanvraag heeft verzonden.	"Kusto.Explorer", "KusWeb"
current_principal	string	De volledig gekwalificeerde naam van de principal-identiteit die de aanvraag heeft verzonden.	"aaduser=1793eb1f-4a18-418c-be4c-728e310c86d3;83af1c0e-8c6d-4f09-b249-c67a2e8fda65"
query_consistency	string	Voor query's: de consistentie van de query : strongconsistency of weakconsistency. Deze eigenschap wordt door de beller ingesteld als onderdeel van de aanvraageigenschappen van de aanvraag: de eigenschap van de clientaanvraag die moet worden ingesteld is: queryconsistency.	"strongconsistency", "weakconsistency"
request_description	string	Aangepaste tekst die de auteur van de aanvraag kan bevatten. De tekst wordt door de aanroeper ingesteld als onderdeel van de eigenschappen van de clientaanvraag: de eigenschap van de clientaanvraag die moet worden ingesteld is: request_description.	"Some custom description"; automatisch ingevuld voor dashboards: "dashboard:{dashboard_id};version:{version};sourceId:{source_id};sourceType:{tile/parameter}"
request_text	string	De verborgen tekst van de aanvraag. Verborgen letterlijke tekenreeksen die zijn opgenomen in de querytekst, worden vervangen door meerdere stertekens (*). Opmerking: alleen de voorlooptekens 65.536 tekens van de aanvraagtekst worden geëvalueerd.	".show version"
request_type	string	Het type aanvraag - Command of Query.	"Command", "Query"

Notitie

Het instellen van de aanvraagopties met behulp van set instructies staat classificatie niet toe. De opties moeten worden ingesteld in het object eigenschappen van de clientaanvraag.

Voorbeelden

Eén workloadgroep

iff(request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query",
    "Ad-hoc queries",
    "default")

Meerdere workloadgroepen

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 == "Kusto.Explorer", "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")

Beheeropdrachten

Gebruik de volgende beheeropdrachten om het classificatiebeleid voor aanvragen van Eventhouse te beheren.

Bevelen	Beschrijving
.alter cluster request classification policy	Wijzigt het beleid voor aanvraagclassificatie van Eventhouse
.alter-merge cluster request classification policy	Hiermee schakelt u het beleid voor aanvraagclassificatie van Een Eventhouse in of uit
.delete cluster request classification policy	Hiermee verwijdert u het beleid voor aanvraagclassificatie van Eventhouse
.show cluster request classification policy	Toont het beleid voor aanvraagclassificatie van Eventhouse

Verwante inhoud

• workloadgroepen
• Eigenschappen van aanvraag