Přehled příkazů pro správu

V rozevíracím seznamu vlevo vyberte službu.
Platí pro: ✅ Microsoft Fabric ✅ Azure Data Explorer

Tento článek popisuje příkazy pro správu, označované také jako řídicí příkazy, které slouží ke správě Kusto. Příkazy pro správu jsou požadavky na službu, aby načetla informace, které nemusí nutně být data v databázových tabulkách, nebo aby změnila stav služby atd.

Odlišování příkazů správy od dotazů

Kusto používá tři mechanismy k rozlišení dotazů a příkazů správy: na úrovni jazyka, na úrovni protokolu a na úrovni rozhraní API. To se provádí pro účely zabezpečení.

Na úrovni jazyka první znak textu požadavku určuje, jestli se jedná o příkaz pro správu nebo dotaz. Příkazy pro správu musí začínat tečkou (.) znakem a žádný dotaz nesmí začínat tímto znakem.

Na úrovni protokolu se pro řídicí příkazy místo dotazů používají různé koncové body HTTP/HTTPS.

Na úrovni rozhraní API se k odesílání příkazů pro správu používají různé funkce, nikoli dotazy.

Kombinování dotazů a příkazů pro správu

Příkazy pro správu můžou odkazovat na dotazy (ale ne naopak) nebo jiné příkazy pro správu. Existuje několik podporovaných scénářů:

• AdminThenQuery: Spustí se příkaz pro správu a jeho výsledek (reprezentovaný jako dočasná tabulka dat) slouží jako vstup dotazu.
• AdminFromQuery: Dotaz nebo .show příkaz správce se spustí a jeho výsledek (reprezentovaný jako dočasná tabulka dat) slouží jako vstup příkazu pro správu.

Všimněte si, že ve všech případech je celá kombinace technicky příkazem pro správu, nikoli dotazem, takže text požadavku musí začínat tečkou (.) a požadavek musí být odeslán do koncového bodu správy služby.

Všimněte si také, že příkazy dotazu se zobrazí v části textu dotazu (nemohou předcházet samotnému příkazu).

Poznámka:

Doporučujeme omezit využití operací AdminThenQuery .

AdminThenQuery je označen jedním ze dvou způsobů:

• Pomocí znaku kanálu (|) proto dotaz zachází s výsledky příkazu pro správu, jako by šlo o jakýkoli jiný operátor dotazu pro vytváření dat.
• Pomocí středníku (;) znaku, který pak zavádí výsledky příkazu správy do speciálního symbolu volaného $command_results, který pak může použít v dotazu libovolný počet.

Například:

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

AdminFromQuery je označena <| kombinací znaků. Například v následujícím příkladu spustíme dotaz, který vytvoří tabulku s jedním sloupcem (pojmenovaným str typem string) a jedním řádkem a zapíšeme ji jako název MyTable tabulky v databázi v kontextu:

.set MyTable <|
let text="Hello, World!";
print str=text