Použití nástroje Kusto.Explorer

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Kusto.Explorer je desktopová aplikace, která umožňuje zkoumat data pomocí dotazovací jazyk Kusto v snadno použitelném uživatelském rozhraní. V tomto článku se dozvíte, jak používat režimy vyhledávání a dotazů, sdílet dotazy a spravovat clustery, databáze a tabulky.

Režim Search++

Režim Search++ umožňuje hledat termín pomocí syntaxe hledání v jedné nebo více tabulkách.

  1. V rozevíracím seznamu Dotaz na kartě Domů vyberte Hledat++.

  2. Vyberte více tabulek.

  3. V části Zvolit tabulky definujte, které tabulky se mají prohledávat, a pak vyberte OK.

  4. Do textového pole zadejte hledanou frázi a vyberte Přejít.

    Heat mapa mřížky tabulky/časového úseku ukazuje, které termíny se zobrazují a kde se zobrazují.

    Hledání + + Kusto Explorer

  5. Vyberte buňku v mřížce a výběrem možnosti Zobrazit podrobnosti zobrazte příslušné položky v podokně výsledků.

    Hledání v Průzkumníku Kusto + výsledky

Režim dotazu

Kusto.Explorer obsahuje výkonný režim dotazů, který umožňuje psát, upravovat a spouštět vložené dotazy. Režim dotazu se dodává se zvýrazněním syntaxe a technologií IntelliSense, takže můžete rychle navýšit znalosti dotazovací jazyk Kusto.

Tato část popisuje, jak spustit základní dotazy v Kusto.Exploreru a jak do dotazů přidat parametry.

Základní dotazy

Pokud máte protokoly tabulek, můžete je začít zkoumat:

StormEvents | count

Když je kurzor na této čáře, je barevný. Stisknutím klávesy F5 spusťte dotaz.

Tady je několik dalších příkladů dotazů:

// Take 10 lines from the table. Useful to get familiar with the data
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (=~ means case insensitive) 
// and take sample of 10 lines
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Základní dotaz v Průzkumníku Kusto

Další informace o dotazovací jazyk Kusto najdete v tématu dotazovací jazyk Kusto.

Poznámka:

Prázdné řádky ve výrazu dotazu můžou ovlivnit, která část dotazu se provede.

Pokud není vybraný žádný text, předpokládá se, že dotaz nebo příkaz jsou oddělené prázdnými řádky. Pokud je vybraný text, spustí se vybraný text.

Parametrizace dotazu na straně klienta

Poznámka:

Kusto obsahuje dva typy technik parametrizace dotazů:

  • Parametrizace dotazů integrovaná v jazyce je implementována na straně serveru a má být používána aplikacemi, které dotazují službu programově. Tato metoda není popsaná v tomto dokumentu.

  • Parametrizace dotazů na straně klienta je funkcí pouze aplikace Kusto.Explorer. Je ekvivalentem použití operací nahrazení řetězce u dotazů před jejich odesláním, aby je služba spustila. Syntaxe není součástí samotného dotazovacího jazyka a nelze ji použít při odesílání dotazů do služby jinými prostředky než Kusto.Explorer.

Pokud použijete stejnou hodnotu v několika dotazech nebo na několika kartách, je velmi neužiteční změnit tuto hodnotu na každém místě, kde se používá. Pro usnadnění používání podporuje Kusto.Explorer parametry dotazu. Parametry dotazu jsou sdíleny mezi kartami, aby je bylo možné snadno znovu použít. Parametry jsou označeny hranatými {} závorkami. Například {parameter1}.

Existující parametry dotazu můžete snadno definovat a upravit:

Snímek obrazovky editoru dotazů zobrazující dotaz s parametry Je zvýrazněná možnost editoru dotazů, parametry dotazu.

Snímek obrazovky s oknem Parametry dotazu zobrazující definované parametry

Můžete mít více sad parametrů (uvedené v poli se seznamem Sada parametrů). Chcete-li manipulovat se seznamem sad parametrů, vyberte Přidat nový nebo Odstranit aktuální .

Seznam sad parametrů

Sdílení dotazů a výsledků

V Kusto.Exploreru můžete dotazy a výsledky sdílet e-mailem. Můžete také vytvořit přímé odkazy, které otevřou a spustí dotaz v prohlížeči.

Sdílení dotazů a výsledků e-mailem

Kusto.Explorer nabízí pohodlný způsob, jak sdílet dotazy a výsledky dotazů e-mailem.

  1. Spusťte dotaz v Kusto.Exploreru.

  2. Na kartě Domů vyberte v části Sdílet dotaz a výsledky do schránky (nebo stiskněte kombinaci kláves Ctrl+Shift+C).

    Snímek obrazovky s položkou nabídky Dotaz a výsledky do schránky

    Kusto.Explorer zkopíruje do schránky následující položky:

    • Váš dotaz
    • Výsledky dotazu (tabulka nebo graf)
    • Podrobnosti o připojení pro cluster a databázi Kusto
    • Odkaz, který dotaz znovu spustí automaticky

  3. Vložte obsah schránky do nové e-mailové zprávy. Snímek obrazovky se sdílenými výsledky v e-mailu

  1. Spusťte dotaz v Kusto.Exploreru.

  2. Na kartě Domů vyberte v části Sdílet dotaz a výsledky do schránky (nebo stiskněte kombinaci kláves Ctrl+Shift+C).

    Snímek obrazovky s položkou nabídky Dotaz a výsledky do schránky

    Kusto.Explorer zkopíruje do schránky následující položky:

    • Váš dotaz
    • Výsledky dotazu (tabulka nebo graf)
    • Podrobnosti o připojení pro eventhouse a databázi
    • Odkaz, který dotaz znovu spustí automaticky

  3. Vložte obsah schránky do nové e-mailové zprávy. Snímek obrazovky se sdílenými výsledky z databáze Fabric KQL v e-mailu

Dotazy s hloubkovým propojením

Můžete vytvořit identifikátor URI, který při otevření v prohlížeči otevře Kusto.Explorer místně a spustí konkrétní dotaz na zadanou databázi Kusto.

Poznámka:

Z bezpečnostních důvodů je pro příkazy pro správu zakázané přímé propojení.

Nejjednodušší způsob, jak vytvořit přímý odkaz, je vytvořit dotaz v Kusto.Exploreru a pak ho zkopírovat Query and results to Clipboard (včetně odkazu a výsledků) do schránky. Pak ho můžete sdílet e-mailem.

Při kopírování do e-mailu se v malém písmu zobrazí několik odkazů, které se mají provést. Příklad:

Spustit: [Web] [Desktop] [Web (Lens)] [Desktop (SAW)]https://help.kusto.windows.net/Samples

Spustit: [Web] [Desktop] [Web (Lens)] [Desktop (SAW)] https://trd-1234.kusto.fabric.microsoft.com

Webový odkaz otevře dotaz v Azure Data Exploreru. Odkaz na plochu je přímý odkaz. Otevře dotaz v Kusto.Exploreru a odpovídajícím způsobem nastaví kontext.

Pokud přesunete odkaz na e-mailovou zprávu a stisknete ctrl+K, uvidíte skutečnou adresu URL.

https://help.kusto.windows.net/Samples?web=0& query=H4sIAAAAAAAAAAAAAasuyS%2fKdS1LzSspVuDlqlEoLs3NTSzKrEpVSM4vzSvR0FRIqlRIyszTCC5JLCoJycxN1VEwT9EEKS1KzUtJLVIoAYolZwAlFQCB3oo%2bTAAAAA%3d%3d

Parametrizované dotazy můžete použít s hloubkovým propojením.

  1. Vytvoření dotazu jako parametrizovaného dotazu (například KustoLogs | where Timestamp > ago({Period}) | count)

  1. Zadejte parametr pro každý parametr dotazu v identifikátoru URI. Pokud chcete zkopírovat identifikátor URI, přejděte na webu Azure Portal na stránku s přehledem vašeho clusteru a pak vyberte identifikátor URI. Identifikátor URI by měl být v následujícím formátu:

    https://<your_cluster>.kusto.windows.net/MyDatabase? web=0&query=KustoLogs+%7c+where+Timestamp+>+ago({Period})+%7c+count&Period=1h

    Nahraďte <your_cluster> názvem clusteru Azure Data Exploreru.

  2. Vložte odkaz na dotaz přímo do podokna dotazu Kusto.Explorer.

  1. Zadejte parametr pro každý parametr dotazu v identifikátoru URI. Pokud chcete zkopírovat identifikátor URI, vyberte v podokně dotazu KQL v prostředcích infrastruktury možnost Kopírovat odkaz na dotaz>do schránky.

  2. Vložte odkaz do podokna dotazu Kusto.Explorer.

Poznámka:

Abyste měli jistotu, že dotaz můžete spustit v Kusto.Exploreru, ujistěte se, že se můžete připojit k databázi uvedené v dotazu.

Omezení

Dotazy jsou omezené na ~2 000 znaků z důvodu omezení prohlížeče, proxy serverů HTTP a nástrojů, které ověřují odkazy, jako je Microsoft Outlook. Omezení je přibližné, protože závisí na délce názvu clusteru a databáze. Další informace najdete na webu https://support.microsoft.com/kb/208427.

Pokud chcete snížit pravděpodobnost dosažení limitu znaků, přečtěte si téma Získání kratších odkazů.

Formát identifikátoru URI je: https://<ClusterCname>.kusto.windows.net/<DatabaseName>web=0?query=<QueryToExecute>

Příklad: https://help.kusto.windows.net/Samples?web=0query=StormEvents+%7c+limit+10

Tento identifikátor URI otevře Kusto.Explorer, připojí se ke clusteru Help Kusto a spustí zadaný dotaz v Samples databázi. Pokud už je spuštěná instance Kusto.Exploreru, otevře spuštěná instance novou kartu a spustí v ní dotaz.

Identifikátor URI otevře Kusto.Explorer a spustí zadaný dotaz. Pokud už existuje spuštěná instance, otevře se nová karta.

Dotazy můžou být dlouhé. Pokud chcete snížit pravděpodobnost, že dotaz překročí maximální délku, použijte metodu dostupnou String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) v klientské knihovně Kusto. Tato metoda vytvoří kompaktnější verzi dotazu. Kratší formát také rozpozná Kusto.Explorer.

<https://\BaseAddress>/groups/1234ab-cd55-6789-0123-e4567fg890hi/databases/01234abc-defg-6789-4567fg890hi?experience=power-bi&extensionScenario=openArtifact&query=1234AAAAAAAAAAAAAAAAAAAAAA567890BBBBBBBB01234567890CCCCCCC1234AAAAAAAAAAAAAAAAAAAAAAAAA567890BBBBBBBBBB01234567890CCCCCCC1234AAAAAAAAAAAAAA567890BBBBBBBBBBBBBB01234567890CCCCCCC%AB%AB%AB

Dotaz se zkomprimuje použitím následující transformace:

 UrlEncode(Base64Encode(gzip(original query)))

Argumenty příkazového řádku Kusto.Explorer

Argumenty příkazového řádku slouží ke konfiguraci nástroje pro provádění dalších funkcí při spuštění. Například načtěte skript a připojte se ke clusteru. Jako takové nejsou argumenty příkazového řádku náhradou za žádné funkce Kusto.Explorer.

Argumenty příkazového řádku se předávají jako součást adresy URL, která se používá k otevření aplikace, podobně jako dotazování na hloubkové propojení.

Syntaxe argumentů příkazového řádku

Kusto.Explorer podporuje několik argumentů příkazového řádku v následující syntaxi (pořadí záleží):

[LocalScriptFile] [QueryString]

Argumenty příkazového řádku

Argument příkazového řádku Popis
LocalScriptFile Název souboru skriptu na místním počítači, který musí mít příponu .kql. Pokud soubor existuje, Kusto.Explorer automaticky načte soubor při spuštění.
Řetězec dotazu Řetězec, který používá formátování řetězce dotazu HTTP. Tato metoda poskytuje více vlastností, jak je popsáno v následující tabulce.

Argumenty řetězce dotazu

Argument Popis
Dotaz ke spuštění
query Dotaz, který se má provést (gzipped, pak kódovaný base64; viz Získání kratších odkazů). Pokud není zadáno, použije querysrc.
querysrc Adresa URL souboru nebo objektu blob, který obsahuje dotaz ke spuštění.
Připojení ke clusteru Kusto
uri Připojovací řetězec clusteru Kusto, ke kterému se chcete připojit.
name Zobrazovaný název připojení ke clusteru Kusto.
Skupina připojení
path Adresa URL souboru skupiny připojení ke stažení (zakódovaná adresa URL).
group Název skupiny připojení.
filename Místní soubor obsahující skupinu připojení.

Příklad

Chcete-li spustit Kusto.Explorer se souborem skriptu volaným c:\temp\script.kql a nakonfigurovaným pro komunikaci s clusterem help, databáze Samples, použijte následující příkaz:

Kusto.Explorer.exe c:\temp\script.kql "uri=https://help.kusto.windows.net/Samples;Fed=true&name=Samples"

Chcete-li spustit Nástroj Kusto.Explorer se souborem skriptu volaným c:\temp\script.kql a nakonfigurovaným pro komunikaci s konkrétní skupinou a databází, použijte následující příkaz:

Kusto.Explorer.exe c:\temp\script.kql "uri=https://<baseaddress>/groups/<GroupID>/databases/<DatabaseID>"

Správa databází, tabulek nebo autorizovaných objektů zabezpečení funkcí

Důležité

Autorizované objekty zabezpečení můžou přidávat nebo odstraňovat pouze správci ve svém vlastním oboru.

  1. Pokud chcete zobrazit seznam autorizovaných objektů zabezpečení, klikněte pravým tlačítkem myši na cílovou entitu na panelu Připojení a vyberte Spravovat autorizované objekty zabezpečení databáze. (Tuto možnost můžete také vybrat v nabídce Správa.)

    Snímek obrazovky s rozevírací nabídkou entity Je zvýrazněná možnost Spravovat autorizované objekty zabezpečení databáze.

  2. Vyberte Přidat objekt zabezpečení a přidejte autorizovaný objekt zabezpečení. Snímek obrazovky s oknem Spravovat autorizované objekty zabezpečení Zvýrazní se možnosti s názvem Drop principal (Instanční objekt) a Add principal (Přidat objekt zabezpečení).

  3. Zadejte podrobnosti o objektu zabezpečení a pak vyberte Přidat objekt zabezpečení.

    Snímek obrazovky s oknem Přidat autorizovaný objekt zabezpečení Tlačítko s názvem Přidat objekt zabezpečení je zvýrazněné.

  4. Potvrďte, že chcete přidat autorizovaný objekt zabezpečení.

    Snímek obrazovky s oknem Zkontrolovat objekt zabezpečení zobrazující žádost o potvrzení přidání autorizovaného objektu zabezpečení

Pokud chcete odstranit existující autorizovaný objekt zabezpečení, vyberte Drop principal (Odstranit objekt zabezpečení ) a potvrďte akci.

Snímekobrazovkyho okna s oknem pro vyřazení instančního objektu

Související obsah