Share via


Skapa en extern tabell med hjälp av azure Data Explorer-webbgränssnittsguiden

En extern tabell är en schemaentitet som refererar till data som lagras utanför Azure Data Explorer-databasen. Azure Data Explorer webbgränssnitt kan skapa externa tabeller genom att ta exempelfiler från en lagringscontainer och skapa ett schema baserat på dessa exempel. Du kan sedan analysera och fråga efter data i externa tabeller utan inmatning i Azure Data Explorer. En kort översikt finns i externa tabeller. Information om olika sätt att skapa externa tabeller finns i Skapa och ändra externa Azure Storage-tabeller. Den här artikeln visar hur du skapar en extern tabell med hjälp av guiden för att skapa.

Förutsättningar

Skapa en extern tabell

  1. I den vänstra menyn väljer du Fråga.

  2. Högerklicka på databasen där du vill skapa den externa tabellen. Välj Skapa extern tabell.

    Skärmbild av alternativet att skapa en extern tabell från frågesidan.

Fönstret Skapa extern tabell öppnas med fliken Mål markerad.

Fliken Mål

  1. Fälten Kluster och Databas är förifyllda. Du kan välja ett annat mål från den nedrullningsbara menyn.
  2. I Tabellnamn anger du ett namn för tabellen.

    Tips

    Tabellnamn kan vara upp till 1 024 tecken, inklusive alfanumeriska tecken, bindestreck och understreck. Specialtecken stöds inte.

  3. Välj Nästa: Källa

Skärmbild av fliken Mål med fälten Kluster, Databas och Tabellnamn.

Fliken Källa

I Länka till containrar finns det två sätt att lägga till en container: Lägg till en container med knappen Välj container och Lägg till en container med knappen Lägg till URL eller Lägg till container.

Du kan lägga till upp till 10 källcontainrar.

Lägg till en container med knappen Välj container

  1. Välj Välj container.

    Skärmbild av knappen Välj container på källfliken.

  2. Välj den relevanta prenumerationen och lagringskontot som är associerat med din container.

    Skärmbild av välj containerfönster.

  3. Välj knappen Lägg till. När verifieringen har slutförts visas en grön kontroll till höger om containerlänken.

    Skärmbild av verifierad containerlänk.

Lägg till en container med knappen Lägg till URL eller Lägg till container

  1. Välj knappen Lägg till URL eller Lägg till container .

    Skärmbild av knappen Lägg till URL.

  2. Ange en anslutningssträng för lagring till källcontainern med läs- och listbehörigheter. När verifieringen har slutförts visas en grön kontroll till höger om containerlänken.

    Skärmbild av att lägga till SAS-URL.

Filfilter

Använd Filfilter för att filtrera de filer som tabellen ska innehålla. Filer kan filtreras efter mappsökväg, fil som börjar med eller filnamnstillägg.

Skärmbild av att välja en schemadefinieringsfil.

Schemadefinieringsfil

Den första källcontainern visar filer under Filfilter.

Skärmbild av fliken Skapa extern tabellkälla i Azure Data Explorer.

  1. Välj den schemadefinierande filen genom att välja cirkeln till vänster om filen. Den här filen används för att generera tabellschemat.
  2. Välj Nästa: schema. Fliken Schema öppnas.

Fliken Schema

På den högra sidan av fliken kan du förhandsgranska dina data. Till vänster kan du lägga till partitioner i tabelldefinitionerna för att komma åt källdata snabbare och få bättre prestanda.

Anteckning

Mappningar ingår inte i definitionen av en extern tabell och stöds inte i den här guiden. Mappningar kan konfigureras senare om det behövs. Vissa funktioner, till exempel att ta bort den sista kolumnen i CSV-filer eller ändra kolumnnamn i JSON-filer, kräver mappningar för att fungera korrekt.

  1. Välj Lägg till partition.

    Skärmbild av visningsfilen för den externa tabellen i Azure Data Explorer.

  2. Partitionsfönstret öppnas. En partition definieras via en undersökväg till filen, som kan ändras med hjälp av fältet Sökvägsprefix . För varje partition som du vill tillämpa fyller du i fälten på följande sätt:

    Fält Beskrivning Obligatorisk/valfri
    Partitionsnamn Används för identifiering av partitionen. Namnet kan vara godtyckligt. Krävs
    Typ Datatypen för kolumnen för datapartitionering. Obligatorisk
    Datakolumn Kolumnen som används för partitionering. Partitionering av virtuella kolumner enligt URL-sökväg. Obligatorisk
    Funktion Funktionen som tillämpas på den datakolumn som används för partitionering. Valfritt
    Funktionsargument Argument som ska användas i partitionsfunktionen. Krävs om funktionen används.
    Sökvägsprefix Undersökvägen till filen där partitioneringen definieras. Det här prefixet ändrar URL:en för den externa tabellen, enligt Uri-förhandsgranskningsrutan , och ska matcha den schemadefinierande fil-URI:n. Valfritt
    Datetime-mönster Datumformat som ska användas för att konstruera tabellens URI-sökväg. Valfritt

    Skärmbild som lägger till partitioner i en extern tabell i Azure Data Explorer.

    Till exempel föreslår partitionsnamnet CustomerName att värdet som ska partitioneras av finns i kundnamndelen av URL:en. I exemplet ovan deklareras två partitioner: en partition över kundens namn och en partition över det datum som är inbäddat i URL:en.

    Anteckning

    Virtuella kolumner visas som en del av schemat som kolumndata som extraheras från filsökvägen, och dessa data kan användas senare i frågor.

  3. Välj Lägg till partition för att lägga till en annan partition.

  4. Välj Spara. Partitionerna som du har lagt till visas nu i listan över partitioner i den vänstra rutan. Partitionerade kolumner kan inte ändras i förhandsversionen.

    Skärmbild av den externa schematabellen Azure Data Explorer.

  5. Välj Nästa: Skapa tabell. När tabellen har skapats öppnas ett externt fönster som har skapats .

  6. Om du vill visa kommandot som används för att skapa tabellen väljer du Visa kommando.

    Skärmbild av att en extern tabell har skapats i Azure Data Explorer.

  7. Om du vill ångra skapandet av den externa tabellen väljer du Verktyg>Ångra.

Fråga den externa tabellen

Den resulterande tabellen innehåller data från alla filer som passar de kriterier som definierats ovan. Du kan köra frågor mot den här tabellen med hjälp av external_table() funktionen . Mer information om hur du kör frågor mot externa tabeller finns i Köra frågor mot en extern tabell.

Skärmbild av tabellutdata från frågor mot extern tabell i Azure Data Explorer.