Sdílet prostřednictvím


Vytvoření kódu pro příjem a dotazování dat pomocí průvodce generátorem ukázkových aplikací

Průvodce generátorem ukázkových aplikací je nástroj, který umožňuje vytvořit funkční aplikaci pro příjem a dotazování dat 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í, správy a ingestování a dotazování dat pomocí sady SDK.

Vygenerovaný kód můžete použít jako směrný plán k napsání vlastních aplikací, úpravě kódu při přechodu nebo zkopírování oddílů kódu do vlastních aplikací. Kód obsahuje komentáře s tipy, osvědčenými postupy, odkazy na referenční materiály a doporučenými změnami TODO při přizpůsobení kódu vašim potřebám.

Požadavky

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 Exploreru:

  1. V levém podokně vyberte Dotaz .

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

    Snímek obrazovky znázorňující ukázkovou kartu generátoru aplikací z místní nabídky tabulky

Vygenerování ukázkové aplikace

Tato část popisuje průvodce obecně. Vybrané možnosti 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:

Cíl

Na kartě Cíl :

  1. Vyberte cluster a databázi.

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

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

    Snímek obrazovky webového uživatelského rozhraní Azure Data Exploreru s kartou Cíl generátoru ukázkových aplikací

  4. Vyberte Další: Zdroj.

Zdroj

Na kartě Zdroj :

  1. Vybírejte z následujících možností:

    • Dotaz a příjem: Nahrajte data pro příjem dat a obdržíte odpovídající kód pro příjem dat i dotazování zadaných dat.
    • Pouze dotaz: Získejte kód pro dotazování 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 generuje vlastnosti schématu a příjmu dat, které můžete podle potřeby upravit. Nastavení schématu:

  1. Potvrďte automaticky vygenerovaný typ komprese.

  2. Zvolte formát dat z formátů podporovaných Azure Data Explorerem pro příjem dat. Různé formáty mají různé specifikace.

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

    Snímek obrazovky znázorňuje, jak otevřít možnosti úpravy schématu

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

Tip

Pokud chcete zobrazit, upravit a zkopírovat příkazy vygenerované z vašich vstupů, otevřete prohlížeč příkazů nad oknem Částečný náhled dat.

Mapování transformací

Formáty dat Parquet, JSON a Avro podporují jednoduché transformace v čase ingestování. Pokud chcete použít transformace mapování, vytvořte nebo aktualizujte sloupec v okně Částečný náhled dat.

Transformace mapování je možné provést u sloupce typu řetězec nebo datum a čas, přičemž zdrojová data mají datový typ int nebo long. Podporované transformace mapování jsou:

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

Další informace naleznete 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 generová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 .