Použití průvodce generátorem ukázkových aplikací k vytvoření kódu pro ingestování a dotazování dat

Průvodce generátorem ukázkových aplikací je nástroj, který umožňuje vytvořit funkční aplikaci, která ingestuje a dotazuje data v preferovaném programovacím jazyce. Vygenerovaný kód odkazuje na příslušné architektury sady SDK a je přizpůsobený vašemu clusteru a datům. Aplikace je samostatnýspustitelný příklad, který ukazuje, jak se připojit ke clusteru pomocí ověřování, spravovat, ingestovat a dotazovat data pomocí sady SDK.

Vygenerovaný kód můžete použít jako směrný plán pro psaní vlastních aplikací, průběžné změny kódu nebo můžete zkopírovat části kódu do vlastních aplikací. Kód obsahuje komentáře s tipy, osvědčené postupy, odkazy na referenční materiály a doporučené změny TODO při přizpůsobování kódu vašim potřebám.

Požadavky

• Účet Microsoft nebo Microsoft Entra identitu uživatele. Předplatné Azure není povinné.
• Cluster a databáze Azure Data Explorer. Vytvořte cluster a databázi.
• Přihlaste se k webovému uživatelskému rozhraní Azure Data Explorer a přidejte připojení ke clusteru.

Poznámka

Pokud chcete povolit přístup mezi clusterem a účtem úložiště bez veřejného přístupu (omezený na privátní koncový bod nebo koncový bod služby), přečtěte si téma Vytvoření spravovaného privátního koncového bodu.

Přístup k průvodci

Průvodce generátorem ukázkových aplikací vás provede procesem příjmu dat.

Přístup k průvodci z webového uživatelského rozhraní Azure Data Explorer:

1. V levém podokně vyberte Dotaz .

2. Klikněte pravým tlačítkem na požadovanou tabulku a vyberte Vygenerovat>ukázkový kód.

   

Vygenerování ukázkové aplikace

Tato část popisuje průvodce obecně. Možnosti, které vyberete, závisí na tom, jaký formát dat ingestujete, jaký druh zdroje dat ingestujete a jestli ingestujete do nové nebo existující tabulky.

Průvodce vás provede následujícími možnostmi:

• Ingestování do existující tabulky
• Ingestování do nové tabulky
• Ingestovat data z:
  • Blob Storage
  • Místní soubor

Cíl

Na kartě Cíl :

1. Vyberte Cluster a databáze.

2. Zvolte, jestli chcete použít existující tabulku nebo novou tabulku. U existující tabulky vyberte tabulku z možností. Novou tabulku pojmenujte.

3. Vyberte programovací jazyk pro vaši aplikaci.

   

4. Vyberte Další: Zdroj.

Source

Na kartě Zdroj :

1. Vybírat můžete z těchto možností:

   • Dotazování a ingestování: Nahrajte data pro příjem dat a přijměte odpovídající kód pro příjem i dotazování zadaných dat.
   • Pouze dotaz: Získejte kód pro dotaz na tabulku vybranou na předchozí kartě.

2. Pokud jste vybrali Dotaz a ingestování, vyberte zdrojový soubor nebo objekt blob pro příjem dat.

3. Vyberte Další: Schéma.

Schéma

Na kartě Schéma služba automaticky vygeneruje schéma a vlastnosti příjmu dat, které můžete podle potřeby upravit. Nastavení schématu:

1. Potvrďte automaticky vygenerovaný typ komprese.

2. Z formátů podporovaných azure Data Explorer pro příjem dat zvolte formát Dat. Různé formáty mají různé specifikace.

3. V okně Náhled částečných dat upravte schéma podle potřeby. Uděláte to tak, že výběrem šipky v horní části sloupce otevřete nabídku s možnostmi změny datového typu, vytvoření nového sloupce, odstranění sloupce a dalších možností. Pokud jsou data ve formátu Parquet, JSON nebo Avro, můžete použít transformace mapování.

   

4. Vyberte Další: Vygenerovat ukázkovou aplikaci.

Tip

Pokud chcete zobrazit, upravit a zkopírovat příkazy vygenerované ze vstupů, otevřete prohlížeč příkazů nad oknem náhledu částečných dat .

Mapování transformací

Datové formáty Parquet, JSON a Avro podporují jednoduché transformace v čase ingestace. Pokud chcete použít transformace mapování, vytvořte nebo aktualizujte sloupec v okně náhledu částečných dat .

Mapování transformací je možné provádět u sloupce typu řetězec nebo datetime, přičemž zdrojová data mají datový typ int nebo long. Mezi podporované transformace mapování patří:

• DateTimeFromUnixSeconds
• DateTimeFromUnixMilliseconds
• DateTimeFromUnixMicroseconds
• DateTimeFromUnixNanoseconds

Další informace najdete v tématu Mapování transformací.

Generovat

Po dokončení mapování schématu a manipulace se sloupci spustí průvodce generátorem ukázkových aplikací proces generování kódu. Po vygenerování kódu bude projekt ukázkové aplikace k dispozici ke stažení jako soubor ZIP.

Podrobné pokyny pro spuštění projektu s vybranou sadou SDK jsou k dispozici po úspěšném vygenerování a v rámci ukázkového souboru projektu. Průvodce navíc nabízí možnosti použití rychlých dotazů k počátečnímu zkoumání dat.

Poznámka

Možná budete muset spustit staženou aplikaci, aby rychlé dotazy fungovaly .

Související obsah

• Nastavení vývojového prostředí pro používání klientských knihoven Kusto