Använd exempelguiden för appgenerator för att skapa kod för att mata in och köra frågor mot dina data
Exempelguiden för appgeneratorn är ett verktyg som gör att du kan skapa en fungerande app för att mata in och köra frågor mot dina data på önskat programmeringsspråk. Den genererade koden refererar till relevanta SDK-ramverk och är skräddarsydd för ditt kluster och dina data. Appen är ett självständigt, körbart exempel som visar hur du ansluter till ett kluster med hjälp av autentisering, administration och inmatning och frågedata med hjälp av SDK:t.
Du kan använda den genererade koden som baslinje för att skriva egna appar, ändra koden när du går, eller så kan du kopiera kodavsnitt till dina egna appar. Koden innehåller kommentarer med tips, metodtips, länkar till referensmaterial och rekommenderade TODO-ändringar när du anpassar koden efter dina behov.
Förutsättningar
- Ett Microsoft-konto eller en Microsoft Entra användaridentitet. En Azure-prenumeration krävs inte.
- Ett Azure Data Explorer-kluster och en databas. Skapa ett kluster och en databas.
- Logga in på Azure Data Explorer-webbgränssnittet och lägg till en anslutning till klustret.
Anteckning
Information om hur du aktiverar åtkomst mellan ett kluster och ett lagringskonto utan offentlig åtkomst (begränsad till privat slutpunkt/tjänstslutpunkt) finns i Skapa en hanterad privat slutpunkt.
Komma åt guiden
Exempelguiden för appgeneratorn vägleder dig genom inmatningsprocessen.
Så här kommer du åt guiden från Azure Data Explorer-webbgränssnittet:
Välj Fråga i det vänstra fönstret.
Högerklicka på den önskade tabellen och välj Generera>exempelkod.
Generera en exempelapp
I det här avsnittet beskrivs guiden i allmänhet. Vilka alternativ du väljer beror på vilket dataformat du matar in, vilken typ av datakälla du matar in från och om du matar in i en ny eller befintlig tabell.
Guiden vägleder dig genom följande alternativ:
- Mata in i en befintlig tabell
- Mata in i en ny tabell
- Mata in data från:
- Blob Storage
- En lokal fil
Mål
På fliken Mål :
Välj kluster och databas.
Välj om du vill använda en befintlig tabell eller en ny tabell. För en befintlig tabell väljer du tabellen från alternativen. Ge tabellen ett namn för en ny tabell.
Välj programmeringsspråket för din app.
Välj Nästa: Källa.
Källa
På fliken Källa :
Välj bland följande alternativ:
- Fråga och mata in: Ladda upp data för inmatning och ta emot motsvarande kod för både inmatning och frågekörning av angivna data.
- Endast fråga: Hämta koden för att fråga den tabell som valts på föregående flik.
Om du har valt Fråga och mata in väljer du källfilen eller bloben för inmatning.
Välj Nästa: Schema.
Schema
På fliken Schema genererar tjänsten automatiskt schema- och inmatningsegenskaper som du kan ändra efter behov. Så här konfigurerar du schemat:
Bekräfta den autogenererade komprimeringstypen.
Välj dataformat från de format som stöds av Azure Data Explorer för inmatning. Olika format har olika specifikationer.
I fönstret Partiell dataförhandsgranskning justerar du schemat efter behov. Det gör du genom att välja pilen överst i en kolumn för att öppna en meny med alternativ för att ändra datatyp, skapa en ny kolumn, ta bort en kolumn med mera. Om dina data är i Parquet-, JSON- eller Avro-format kan du använda mappningstransformeringar.
Välj Nästa: Generera exempelapp.
Tips
Om du vill visa, redigera och kopiera kommandon som genererats från dina indata öppnar du kommandovisningsprogrammet ovanför fönstret Partiell dataförhandsgranskning .
Mappning av transformeringar
Parquet-, JSON- och Avro-dataformat har stöd för enkla inmatningstidstransformeringar. Om du vill använda mappningstransformeringar skapar eller uppdaterar du en kolumn i fönstret Partiell dataförhandsgranskning .
Mappningstransformeringar kan utföras på en kolumn av typen sträng eller datetime, där källdata har datatypen int eller lång. Mappningstransformeringar som stöds är:
- DateTimeFromUnixSeconds
- DateTimeFromUnixMilliseconds
- DateTimeFromUnixMicroseconds
- DateTimeFromUnixNanoseconds
Mer information finns i Mappa transformeringar.
Generera
När du har slutfört schemamappning och kolumnmanipuleringar startar guiden för exempelappgenerator kodgenerering. Efter kodgenereringen kommer exempelappprojektet att vara tillgängligt för nedladdning som en ZIP-fil.
Detaljerade instruktioner för att köra projektet med den valda SDK:en finns vid generering och i exempelprojektfilen. Dessutom ger guiden dig alternativ för att använda snabbfrågor för inledande utforskning av dina data.
Anteckning
Du kan behöva köra den nedladdade appen för att snabbfrågorna ska fungera.