Freigeben über


Erstellen einer externen Tabelle mithilfe des Assistenten auf der Azure Data Explorer-Webbenutzeroberfläche

Bei einer externen Tabelle handelt es sich um eine Schemaentität, die auf Daten verweist, die außerhalb der Azure Data Explorer-Datenbank gespeichert sind. Über die Webbenutzeroberfläche von Azure Data Explorer können externe Tabellen erstellt werden. Hierzu wird auf der Grundlage von Beispieldateien aus einem Speichercontainer ein Schema erstellt. Anschließend können Daten in externen Tabellen analysiert und abgefragt werden, ohne sie in Azure Data Explorer zu erfassen. Eine kurze Übersicht finden Sie unter externe Tabellen. Informationen zu verschiedenen Erstellungsmethoden für externe Tabellen finden Sie unter Erstellen und Ändern externer Azure Storage-Tabellen. In diesem Artikel erfahren Sie, wie Sie eine externe Tabelle mithilfe des Erstellungsassistenten erstellen.

Voraussetzungen

Erstellen einer externen Tabelle

  1. Wählen Sie im Menü auf der linken Seite Abfrage aus.

  2. Klicken Sie mit der rechten Maustaste auf die Datenbank, in der Sie die externe Tabelle erstellen möchten. Wählen Sie "Externe Tabelle erstellen" aus.

    Screenshot der Option zum Erstellen einer externen Tabelle auf der Abfrageseite.

Das Fenster Externe Tabelle erstellen wird geöffnet, und die Registerkarte Ziel ist ausgewählt.

Registerkarte „Ziel“

  1. Die Felder Cluster und Datenbank sind vorausgefüllt. Sie können ein anderes Ziel aus dem Dropdownmenü auswählen.
  2. Geben Sie unter Tabellenname einen Namen für Ihre Tabelle ein.

    Tipp

    Tabellennamen können bis zu 1.024 Zeichen umfassen, einschließlich alphanumerischer Zeichen, Bindestrichen und Unterstrichen. Sonderzeichen werden nicht unterstützt.

  3. Wählen Sie "Weiter" aus: Quelle.

Screenshot: Registerkarte „Ziel“ mit den Feldern „Cluster“, „Datenbank“ und „Tabelle“

Registerkarte „Quelle“

In "Link zu Containern" können Sie einen Container auf zwei Arten hinzufügen: Hinzufügen eines Containers mit der Schaltfläche " Container auswählen " und "Container hinzufügen" mit der Schaltfläche " URL hinzufügen" oder "Container hinzufügen ".

Sie können bis zu zehn Quellcontainer hinzufügen.

Hinzufügen eines Containers über die Schaltfläche Container auswählen

  1. Wählen Sie Container aus.

    Screenshot der Schaltfläche „Container auswählen“ auf der Registerkarte „Quelle“

  2. Wählen Sie das Abonnement- und Speicherkonto aus, das Ihr Container verwendet.

    Screenshot: Fenster „Container auswählen“

  3. Wählen Sie Hinzufügen aus. Nach Abschluss der Überprüfung erscheint rechts neben dem Containerlink ein grünes Häkchen.

    Screenshot des überprüften Containerlinks

Hinzufügen eines Containers über die Schaltfläche „URL hinzufügen“ oder „Container hinzufügen“

  1. Wählen Sie die Schaltfläche URL hinzufügen oder Container hinzufügen aus.

    Screenshot der Schaltfläche „URL hinzufügen“

  2. Geben Sie eine Speicherverbindungszeichenfolge für Ihren Quellcontainer mit Lese- und Listenberechtigungen ein. Nach Abschluss der Überprüfung wird rechts neben dem Containerlink ein grüner Haken angezeigt.

    Screenshot zum Hinzufügen der SAS-URL.

Dateifilter

Verwenden Sie Dateifilter, um die Dateien zu filtern, die in der Tabelle enthalten sein sollen. Sie können Dateien nach Ordnerpfad, Dateianfang oder Dateierweiterung filtern.

Screenshot: Auswählen der Schemadefinitionsdatei

Schemadefinitionsdatei

Der erste Quellcontainer zeigt Dateien unterhalb von Dateifiltern an.

Screenshot: Erstellen einer externen Tabelle: Registerkarte „Quelle“ in Azure Data Explorer

  1. Wählen Sie die Schemadefinitionsdatei aus, indem Sie den Kreis links neben der Datei auswählen. Diese Datei wird verwendet, um das Tabellenschema zu generieren.
  2. Wählen Sie die Option Weiter: Schema aus. Die Registerkarte Schema wird geöffnet.

Registerkarte „Schema“

Auf der rechten Seite der Registerkarte können Sie ihre Daten in der Vorschau anzeigen. Auf der linken Seite können Sie Partitionen zu Ihren Tabellendefinitionen hinzufügen, um schneller auf die Quelldaten zuzugreifen und eine bessere Leistung zu erzielen.

Hinweis

Zuordnungen sind nicht Teil der Definition einer externen Tabelle, und der Assistent unterstützt sie nicht. Sie können Zuordnungen später bei Bedarf konfigurieren. Einige Funktionen wie etwa das Löschen der letzten Spalte in CSV-Dateien oder das Ändern von Spaltennamen in JSON-Dateien, erfordern Zuordnungen, damit sie ordnungsgemäß funktionieren.

  1. Wählen Sie Partition hinzufügen aus.

    Screenshot von Ansichtsdatei für externe Tabelle in Azure Data Explorer.

  2. Das Partitionsfenster wird geöffnet. Eine Partition wird über einen Unterpfad der Datei definiert, den Sie mithilfe des Pfadpräfixfelds ändern können. Füllen Sie für jede Partition, die Sie anwenden möchten, die Felder wie folgt aus:

    Feld Beschreibung Erforderlich/Optional
    Partitionsname Dient zur Identifizierung der Partition. Sie können einen beliebigen Namen verwenden. Erforderlich
    Typ Der Datentyp der Datenpartitionierungsspalte. Erforderlich
    Datenspalte Die für die Partitionierung verwendete Spalte. Virtuelle Spalten werden auf der Grundlage des URL-Pfads partitioniert. Erforderlich
    Funktion Die auf die für die Partitionierung verwendete Datenspalte angewendete Funktion. Wahlfrei
    Funktionsargument Argument, das in der Partitionsfunktion verwendet werden soll. Erforderlich, wenn eine Funktion verwendet wird.
    Pfadpräfix Der Unterpfad der Datei, für die die Partitionierung definiert wird. Dieses Präfix ändert die URL der externen Tabelle (wie im Feld URI-Vorschau zu sehen) und muss dem URI der Schemadefinitionsdatei entsprechen. Wahlfrei
    DateTime-Muster Format des Datums, das Sie zum Erstellen des Tabellen-URI-Pfads verwenden. Wahlfrei

    Screenshot: Hinzufügen von Partitionen zur externen Tabelle in Azure Data Explorer

    Der Partitionsname CustomerName (Kundenname) deutet beispielsweise darauf hin, dass der Wert für die Partitionierung in der Kundennamenkomponente der URL enthalten ist. Im vorstehenden Beispiel werden zwei Partitionen deklariert: eine Partition über den Kundennamen und eine Partition über dem in die URL eingebetteten Datum.

    Hinweis

    Virtuelle Spalten werden als Teil des Schemas angezeigt, da die Spaltendaten aus dem Dateipfad extrahiert wurden, und Sie können diese Daten später in Abfragen verwenden.

  3. Wählen Sie Partition hinzufügen aus, um eine weitere Partition hinzuzufügen.

  4. Wählen Sie Speichern. Die hinzugefügten Partitionen werden nun im linken Bereich in der Liste Partitionen angezeigt. Partitionierte Spalten können in der Vorschau nicht geändert werden.

    Screenshot: Schema der externen Tabelle in Azure Data Explorer

  5. Wählen Sie die Option Weiter: Tabelle erstellen aus. Wenn Sie die Tabelle erstellen, wird ein Fenster "Externe Tabelle" erfolgreich erstellt .

  6. Der zum Erstellen der Tabelle verwendete Befehl kann durch Auswählen von Befehl anzeigen angezeigt werden.

    Screenshot: Erfolgreiche Erstellung einer externen Tabelle in Azure Data Explorer

  7. Wenn Sie die Erstellung der externen Tabelle rückgängig machen möchten, wählen Sie Tools>Rückgängig aus.

Externe Tabelle abfragen

Die resultierende Tabelle enthält Daten aus allen Dateien, die den von Ihnen definierten Kriterien entsprechen. Sie können diese Tabelle mithilfe der external_table() Funktion abfragen. Weitere Informationen zum Abfragen externer Tabellen finden Sie unter Abfragen einer externen Tabelle.

Screenshot: Tabellenausgabe nach dem Abfragen der externen Tabelle in Azure Data Explorer