Felügyeleti parancsok áttekintése
Ez a cikk a Kusto kezeléséhez használt felügyeleti parancsokat, más néven vezérlőparancsokat ismerteti. A felügyeleti parancsok olyan kérések a szolgáltatáshoz, amelyek nem feltétlenül az adatbázistáblák adatai, vagy a szolgáltatás állapotának módosítása stb.
Felügyeleti parancsok megkülönböztetése a lekérdezésektől
A Kusto három mechanizmussal különbözteti meg a lekérdezéseket és a felügyeleti parancsokat: a nyelv, a protokoll és az API szintjén. Ez biztonsági okokból történik.
Nyelvi szinten a kérés szövegének első karaktere határozza meg, hogy a kérés felügyeleti parancs vagy lekérdezés-e. A felügyeleti parancsnak pont (.
) karakterrel kell kezdődnie, és egyetlen lekérdezés sem indulhat el ezzel a karakterrel.
A protokoll szintjén a rendszer más HTTP/HTTPS-végpontokat használ a vezérlési parancsokhoz, mint a lekérdezésekhez.
AZ API szintjén a rendszer különböző függvényeket használ a felügyeleti parancsok küldésére a lekérdezések helyett.
Lekérdezések és felügyeleti parancsok kombinálása
A felügyeleti parancsok hivatkozhatnak lekérdezésekre (de fordítva nem) vagy más felügyeleti parancsra. Többféle támogatott forgatókönyv létezik:
- AdminThenQuery: A rendszer végrehajt egy felügyeleti parancsot, amelynek eredménye (ideiglenes adattáblaként) egy lekérdezés bemeneteként szolgál.
- AdminFromQuery: A rendszer végrehajt egy lekérdezést vagy egy
.show
rendszergazdai parancsot, amelynek eredménye (ideiglenes adattáblaként) egy felügyeleti parancs bemeneteként szolgál.
Vegye figyelembe, hogy a teljes kombináció gyakorlatilag egy felügyeleti parancs, nem lekérdezés, ezért a kérés szövegének pont (.
) karakterrel kell kezdődnie, és a kérést el kell küldeni a szolgáltatás felügyeleti végpontjának.
Azt is vegye figyelembe, hogy a lekérdezési utasítások a szöveg lekérdezési részén belül jelennek meg (nem előzhetik meg magát a parancsot).
Megjegyzés
Javasoljuk, hogy korlátozza az AdminThenQuery műveletek használatát.
Az AdminThenQuery a következő két módszer egyikével jelenik meg:
- A lekérdezés tehát egy cső (
|
) karakter használatával úgy kezeli a felügyeleti parancs eredményeit, mintha bármely más adattermelő lekérdezési operátor lenne. - Egy pontosvessző (
;
) karakter használatával, amely a felügyeleti parancs eredményeit egy speciális szimbólumba$command_results
vezeti be, amelyet aztán tetszőleges számú alkalommal használhat a lekérdezésben.
Például:
// 1. Using pipe: Count how many tables are in the database-in-scope:
.show tables
| count
// 2. Using semicolon: Count how many tables are in the database-in-scope:
.show tables;
$command_results
| count
// 3. Using semicolon, and including a let statement:
.show tables;
let useless=(n:string){strcat(n,'-','useless')};
$command_results | extend LastColumn=useless(TableName)
Az AdminFromQuery forgatókönyvet a <|
karakterkombináció jelzi. A következő példában például egy olyan lekérdezést hajtunk végre, amely egyetlen oszlopból (string
típus str
elnevezéssel) és egyetlen sorból álló táblát hoz létre, és a célként szolgáló adatbázisban a MyTable
táblanévként írja be:
.set MyTable <|
let text="Hello, World!";
print str=text
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: