Besorolási szabályzat kérése

A besorolási folyamat a kérelmek jellemzői alapján hozzárendeli a bejövő kéréseket egy számítási feladatcsoporthoz. Testre szabhatja a besorolási logikát egy felhasználó által definiált függvény megírásával egy fürtszintű kérelembesorolási szabályzat részeként.

Engedélyezett kérelembesorolási szabályzat hiányában az összes kérés a default számítási feladatcsoportba van besorolva.

Szabályzatobjektum

A szabályzat a következő tulajdonságokkal rendelkezik:

• IsEnabled: bool – Azt jelzi, hogy a szabályzat engedélyezve van-e.
• ClassificationFunction: string – A kérések osztályozásához használandó függvény törzse.

Besorolási függvény

A bejövő kérések besorolása egy felhasználó által definiált függvényen alapul. A függvény eredményei a kérések meglévő számításifeladat-csoportokba való besorolására szolgálnak.

A felhasználó által definiált függvény a következő jellemzőkkel és viselkedésekkel rendelkezik:

• Ha IsEnabled a szabályzatban értékre true van állítva, a felhasználó által definiált függvény minden új kérelemre ki lesz értékelve.
• A felhasználó által definiált függvény számítási feladatcsoport-környezetet biztosít a kéréshez a kérelem teljes élettartama során.
• A kérés a számításifeladat-csoport kontextusát default kapja a következő helyzetekben:
  • A felhasználó által definiált függvény egy üres sztringet vagy defaultegy nem létező számításifeladat-csoport nevét adja vissza.
  • A függvény bármilyen okból meghiúsul.
• Egy adott időpontban csak egy felhasználó által definiált függvény jelölhető ki.

Fontos

A rendszer kiértékeli a kérelembesorolási függvényt a fürtön futó minden egyes kérelemhez. Javasoljuk, hogy tartsa a lehető legkönnyűbben, és ne foglaljon bele nagy számítási műveletet. Például ne kelljen sok reguláris kifejezést kiértékelnie a végrehajtás részeként.

Követelmények és korlátozások

Besorolási függvény:

• Egyetlen típusú skaláris értéket stringkell visszaadnia, amely annak a számítási feladatcsoportnak a neve, amelyhez hozzá szeretné rendelni a kérést.

• Nem hivatkozhat más entitásra (adatbázisra, táblára vagy függvényre).

  • Pontosabban – nem feltétlenül használja a következő függvényeket és operátorokat:
    • cluster()
    • database()
    • table()
    • external_table()
    • externaldata

• Hozzáféréssel rendelkezik egy speciális dynamic szimbólumhoz, egy nevű request_propertiestulajdonságcsomaghoz, amely a következő tulajdonságokkal rendelkezik:

  Név	Típus	Leírás	Példák
  current_database	string	A kérelemadatbázis neve.	"MyDatabase"
  current_application	string	A kérelmet küldő alkalmazás neve.	"Kusto.Explorer", "KusWeb"
  current_principal	string	A kérést küldő fő identitás teljes neve.	"aaduser=1793eb1f-4a18-418c-be4c-728e310c86d3;83af1c0e-8c6d-4f09-b249-c67a2e8fda65"
  query_consistency	string	Lekérdezések esetén: a lekérdezés konzisztenciája – strongconsistency vagy weakconsistency. Ezt a tulajdonságot a hívó a kérelem kérelemtulajdonságainak részeként állíthatja be: A beállítandó ügyfélkérési tulajdonság a következő: queryconsistency.	"strongconsistency", "weakconsistency"
  request_description	string	Egyéni szöveg, amelyet a kérés szerzője tartalmazhat. A szöveget a hívó a kérelem Ügyfélkérés tulajdonságainak részeként állíthatja be: A beállítandó ügyfélkérési tulajdonság a következő: request_description.	"Some custom description"; automatikusan kitöltve az irányítópultokhoz: "dashboard:{dashboard_id};version:{version};sourceId:{source_id};sourceType:{tile/parameter}"
  request_text	string	A kérelem elhomályosított szövege. A lekérdezés szövegében található elmosott sztringkonstansokat több star (*) karakter váltja fel. Megjegyzés: a rendszer csak a kérelem szövegének kezdő 65 536 karakterét értékeli ki.	".show version"
  request_type	string	A kérelem típusa – Command vagy Query.	"Command", "Query"

Megjegyzés

A fent említett kérésbeállítások utasítások használatával történő set beállítása nem teszi lehetővé a besorolást. A beállításokat az ügyfélkérés tulajdonságai objektumban kell megadni.

Példák

Egyetlen számítási feladatcsoport

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

Több számításifeladat-csoport

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

Felügyeleti parancsok

A fürt kérelembesorolási szabályzatának kezeléséhez használja az alábbi felügyeleti parancsokat.

Parancs	Leírás
.alter cluster request classification policy	Módosítja a fürt kérelembesorolási szabályzatát
.alter-merge cluster request classification policy	Fürt kérelembesorolási szabályzatának engedélyezése vagy letiltása
.delete cluster request classification policy	Törli a fürt kérelembesorolási szabályzatát
.show cluster request classification policy	A fürt kérelembesorolási szabályzatának megjelenítése