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
- Účet Microsoft nebo identita uživatele Microsoft Entra. Předplatné Azure není povinné.
- Cluster a databáze Azure Data Exploreru. Vytvořte cluster a databázi.
- Přihlaste se k webovému uživatelskému rozhraní Azure Data Exploreru 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 Exploreru:
V levém podokně vyberte Dotaz .
Klikněte pravým tlačítkem myši na požadovanou tabulku a vyberte Vygenerovat>ukázkový kód.
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:
- Ingestování do existující tabulky
- Ingestování do nové tabulky
- Příjem dat z:
- Blob Storage
- Místní soubor
Cíl
Na kartě Cíl :
Vyberte cluster a databázi.
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.
Vyberte programovací jazyk pro vaši aplikaci.
Vyberte Další: Zdroj.
Zdroj
Na kartě Zdroj :
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ě.
Pokud jste vybrali dotaz a ingestování, vyberte zdrojový soubor nebo objekt blob pro příjem dat.
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:
Potvrďte automaticky vygenerovaný typ komprese.
Zvolte formát dat z formátů podporovaných Azure Data Explorerem pro příjem dat. Různé formáty mají různé specifikace.
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í.
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 .