Freigeben über


Erfassen von Daten aus Azure-Speicher

In diesem Artikel erfahren Sie, wie Sie Daten aus Azure-Speicher (ADLS Gen2-Container, Blobcontainer oder einzelnen Blobs) in eine neue oder vorhandene Tabelle abrufen.

Voraussetzungen

Source

  1. Wählen Sie im unteren Menüband Ihrer KQL-Datenbank Daten abrufen aus.

    Im Fenster Daten abrufen ist die Registerkarte Quelle ausgewählt.

  2. Wählen Sie die Datenquelle aus der verfügbaren Liste aus. In diesem Beispiel erfassen Sie Daten aus Azure-Speicherauf.

    Screenshot des Fensters „Daten abrufen“ mit ausgewählter Quellregisterkarte.

Konfigurieren

  1. Wählen Sie eine Zieltabelle aus. Wenn Sie Daten in einer neuen Tabelle erfassen möchten, wählen Sie +Neue Tabelle aus, und geben Sie einen Tabellennamen ein.

    Hinweis

    Tabellennamen können bis zu 1024 Zeichen umfassen und alphanumerische Zeichen, Bindestriche und Unterstriche enthalten. Sonderzeichen werden nicht unterstützt.

  2. Um Ihre Datenquelle hinzuzufügen, fügen Sie die Verbindungszeichenfolge Ihres Speichers in das Feld URI ein und wählen dann + aus. In der folgenden Tabelle sind die unterstützten Authentifizierungsmethoden und die Berechtigungen aufgeführt, die zum Aufnehmen von Daten aus Azure Storage erforderlich sind.

    Authentifizierungsmethode Einzelnes Blob (Binary Large Object) BLOB-Container Azure Data Lake Storage Gen2
    Token für gemeinsamen Zugriff (SAS) Lesen und Schreiben Lesen und Auflisten Lesen und Auflisten
    Zugriffsschlüssel für das Speicherkonto

    Hinweis

    • Sie können entweder bis zu 10 einzelne Blobs hinzufügen oder bis zu 5000 Blobs aus einem einzelnen Container erfassen. Sie können nicht beide gleichzeitig erfassen.
    • Jedes Blob kann maximal 1 GB (dekomprimiert) sein.
    1. Wenn Sie eine Verbindungszeichenfolge für einen BLOB-Container oder einen Azure Data Lake Storage Gen2 eingefügt haben, können Sie folgende optionale Filter hinzufügen:

      Screenshot des Tabs „Konfigurieren“ mit ausgewählter neuer Tabelle und ausgewählter Beispieldatendatei.

      Einstellung Feldbeschreibung
      Dateifilter (optional)
      Ordnerpfad Filtert Daten zum Erfassen von Dateien mit einem bestimmten Ordnerpfad.
      Dateierweiterung Filtert Daten, um Dateien nur mit einer bestimmten Dateierweiterung zu erfassen.
  3. Klicken Sie auf Weiter.

Inspizieren

Die Registerkarte Prüfen wird mit einer Vorschau der Daten geöffnet.

Um den Erfassungsvorgang abzuschließen, wählen Sie Fertig stellen aus.

Screenshot der Registerkarte „Einfügen“

Optional:

Bearbeiten von Spalten

Hinweis

  • Bei Tabellenformaten (CSV, TSV, PSV) können Sie eine Spalte nicht zweimal zuordnen. Löschen Sie bei einer Zuordnung zu einer vorhandenen Spalte zunächst die neue Spalte.
  • Der Typ einer vorhandenen Spalte kann nicht geändert werden. Wenn Sie als Zuordnungsziel eine Spalte mit einem anderen Format verwenden, erhalten Sie ggf. leere Spalten.

Die Änderungen, die Sie an einer Tabelle vornehmen können, hängen von den folgenden Parametern ab:

  • Die Tabelle ist neu oder vorhanden.
  • Die Zuordnung ist neu oder vorhanden.
Tabellentyp Zuordnungstyp Verfügbare Anpassungen
Neue Tabelle Neue Zuordnung Spalte umbenennen, Datentyp ändern, Datenquelle ändern, Zuordnungstransformation, Spalte hinzufügen, Spalte löschen
Vorhandene Tabelle Neue Zuordnung Spalte hinzufügen (für die Sie dann den Datentyp ändern und die Sie umbenennen und aktualisieren können)
Vorhandene Tabelle Vorhandene Zuordnung Keine

Screenshot der zur Bearbeitung geöffneten Spalten.

Zuordnungstransformationen

Einige der Datenformatzuordnungen (Parquet, JSON und Avro) unterstützen einfache Transformationen während der Erfassung. Erstellen oder aktualisieren Sie zum Anwenden von Zuordnungstransformationen eine Spalte im Fenster Spalten bearbeiten.

Zuordnungstransformationen können für eine Spalte ausgeführt werden, für die als Typ der Wert „string“ oder „datetime“ und für Quelle der Datentyp „int“ oder „long“ angegeben ist. Die folgenden Zuordnungstransformationen werden unterstützt:

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

Erweiterte Optionen basierend auf dem Datentyp

Tabellarisch (CSV, TSV, PSV):

  • Wenn Sie Tabellenformate in eine bestehende Tabelle übernehmen, wählen Sie Erweitert>Tabellenschema beibehalten aus. Tabellendaten enthalten nicht unbedingt die Spaltennamen, die verwendet werden, um Quelldaten den vorhandenen Spalten zuzuordnen. Wenn diese Option aktiviert ist, wird die Zuordnung nach der geltenden Reihenfolge durchgeführt, und das Tabellenschema bleibt unverändert. Wenn diese Option deaktiviert ist, werden unabhängig von der Datenstruktur neue Spalten für eingehende Daten erstellt.

  • Wählen Sie Erweitert>Erste Zeile ist Spaltenüberschrift, um die erste Zeile als Spaltennamen zu verwenden.

    Screenshot der erweiterten Optionen

JSON:

  • Wählen Sie Erweitert>Verschachtelte Ebenen, von 1 bis 100, um die Spaltenaufteilung der JSON-Daten festzulegen.

  • Wenn Sie Erweitert>JSON-Zeilen mit Fehlern überspringen wählen, werden die Daten im JSON-Format eingelesen. Wenn Sie das Kontrollkästchen nicht aktivieren, werden die Daten im MultiJSON-Format erfasst.

    Screenshot der erweiterten Optionen

Zusammenfassung

Im Fenster Datenaufbereitung werden alle drei Schritte mit grünen Häkchen markiert, wenn die Datenerfassung erfolgreich abgeschlossen wurde. Sie können eine Karte auswählen, die abgefragt werden soll, die aufgenommenen Daten ablegen oder ein Dashboard Ihrer Erfassungszusammenfassung anzeigen.

Screenshot: Zusammenfassungsseite mit abgeschlossener Datenerfassung