Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel erfahren Sie, wie Sie Daten aus Azure Storage (Azure Data Lake Storage Gen2 Containern, Blobcontainern oder einzelnen Blobs) in eine Tabelle in einer KQL-Datenbank abrufen. Sie können Daten kontinuierlich oder als einmalige Aufnahme aufnehmen. Nach Abschluss der Erfassung sind die Daten für die Abfrage verfügbar.
Kontinuierliche Datenaufnahme (Vorschau): Die kontinuierliche Datenaufnahme richtet eine Datenaufnahmepipeline ein, die es einem Ereignishaus ermöglicht, Azure Storage-Ereignisse zu überwachen. Die Pipeline benachrichtigt das Ereignishaus, Informationen abzurufen, wenn abonnierte Ereignisse auftreten. Die Ereignisse sind BlobCreated und BlobRenamed.
One-time ingestion: Verwenden Sie diese Methode, um Daten aus Azure Storage als einmaligen Vorgang abzurufen.
Anmerkung
- Ein fortlaufender Aufnahmedatenstrom kann sich auf Ihre Abrechnung auswirken. Weitere Informationen finden Sie unter Eventhouse- und KQL-Datenbanknutzung.
Voraussetzungen
- Ein Arbeitsbereich mit einer Microsoft Fabric aktivierten Kapazität.
- Eine KQL-Datenbank mit Bearbeitungsberechtigungen.
- Ein Azure Storagekonto.
Voraussetzungen für die kontinuierliche Aufnahme
- Eine Fabric-Arbeitsbereichsidentität. Mein Arbeitsbereich wird nicht unterstützt. Erstellen Sie bei Bedarf einen neuen Arbeitsbereich.
In Azure:
- Registern Sie den Ereignisrasterressourcenanbieter mit Ihrem Azure-Abonnement.
- Weisen Sie der Arbeitsbereichsidentität Rollenberechtigungen für den Speicher-BLOB-Datenleser zu.
-
Erstellen Sie einen BLOB-Container , um die Datendateien zu speichern.
Laden Sie eine Datendatei hoch. Die Datendateistruktur wird verwendet, um das Tabellenschema zu definieren. Weitere Informationen finden Sie unter Datenformate, die von Real-Time Intelligenceunterstützt werden.
Anmerkung
Sie müssen eine Datendatei hochladen:
- Vor der Konfiguration zum Definieren des Tabellenschemas während der Einrichtung.
- Nach der Konfiguration, um die kontinuierliche Aufnahme auszulösen, um Daten in der Vorschau anzuzeigen und die Verbindung zu überprüfen.
Anmerkung
Die kontinuierliche Aufnahme von Azure Storage wird auch unterstützt, wenn das Speicherkonto mit privaten Endpunkten (Private Link) konfiguriert ist. Stellen Sie sicher, dass der Fabric Arbeitsbereich über den konfigurierten privaten Netzwerkpfad auf das Speicherkonto zugreifen kann.
Fügen Sie die Rollenzuweisung der Identität des Arbeitsbereichs zum Speicherkonto hinzu
Kopieren Sie in den Arbeitsbereichseinstellungen in Fabric Ihre Arbeitsbereichsidentitäts-ID.
Navigieren Sie im Azure-Portal zu Ihrem Azure Storage Konto, und wählen Sie Access Control (IAM)>Add>Add role assignment aus.
Wählen Sie den Speicher-BLOB-Datenleser aus.
Wählen Sie im Dialogfeld " Rollenzuweisung hinzufügen " +Mitglieder auswählen.
Fügen Sie die Arbeitsbereichsidentitäts-ID ein, wählen Sie die Anwendung aus, und wählen Sie dann ">Überprüfen+ zuweisen" aus.
Erstellen eines BLOB-Containers und Hochladen einer Datendatei
Wählen Sie im Speicherkonto "Container" aus.
Wählen Sie +Container, geben Sie einen Namen für den Container ein, und wählen Sie "Speichern" aus.
Geben Sie den Container ein, wählen Sie "Hochladen" aus, und laden Sie die zuvor vorbereitete Datendatei hoch.
Weitere Informationen finden Sie unter unterstützten Formaten und unterstützten Komprimierungen.
Wählen Sie im Kontextmenü [...]Containereigenschaften aus, und kopieren Sie die URL, die während der Konfiguration eingegeben werden soll.
Wählen Sie Azure Storage als Datenquelle aus.
Öffnen Sie den Datenfluss abrufen, und wählen Sie Azure Storage als Quelle aus.
Öffnen Sie im Arbeitsbereich das Eventhouse, und wählen Sie die Datenbank aus.
Wählen Sie im Menüband der KQL-Datenbank die Option "Daten abrufen" aus.
Wählen Sie die Datenquelle aus der verfügbaren Liste aus. In diesem Beispiel werden Daten aus Azure Storage aufgenommen.
Konfigurieren
Wählen Sie eine Zieltabelle aus. Wenn Sie Daten in eine neue Tabelle aufnehmen möchten, wählen Sie +Neue Tabelle aus, und geben Sie einen Tabellennamen ein.
Anmerkung
Tabellennamen können bis zu 1.024 Zeichen umfassen, einschließlich Leerzeichen, alphanumerischen Zeichen, Bindestrichen und Unterstrichen. Sonderzeichen werden nicht unterstützt.
Stellen Sie unter Azure-Blob-Storage-Verbindung konfigurieren sicher, dass Fortlaufende Erfassung aktiviert ist. Sie ist standardmäßig aktiviert.
Konfigurieren Sie die Verbindung, indem Sie eine neue Verbindung erstellen oder eine vorhandene Verbindung verwenden.
So erstellen Sie eine neue Verbindung:
Wählen Sie "Mit einem Speicherkonto verbinden" aus.
Verwenden Sie die folgenden Beschreibungen, um die Felder auszufüllen.
Einstellung Feldbeschreibung Abonnement Das Speicherkontoabonnement. Blob-Speicherkonto Speicherkontoname. Behälter Der Speichercontainer, der die Datei enthält, die Sie importieren möchten. Öffnen Sie im Feld Verbindung das Dropdownmenü, und wählen Sie + Neue Verbindung aus, und wählen Sie dann Speichern>Schließen aus. Die Verbindungseinstellungen sind vorgefüllt.
Anmerkung
Wenn Sie eine neue Verbindung erstellen, erstellen Sie auch einen neuen Eventstream. Der Name ist definiert als
<storage_account_name>_eventstream. Entfernen Sie den kontinuierlichen Erfassungsereignisstream nicht aus dem Arbeitsbereich.So verwenden Sie eine vorhandene Verbindung:
Wählen Sie ein vorhandenes Speicherkonto aus.
Verwenden Sie die folgenden Beschreibungen, um die Felder auszufüllen.
Einstellung Feldbeschreibung RTAStorageAccount Ein Ereignisstream von Fabric, der mit Ihrem Speicherkonto verbunden ist. Behälter Der Speichercontainer, der die Datei enthält, die Sie importieren möchten. Verbindung Dieses Feld wird mit dem Verbindungszeichenfolge vorab aufgefüllt. Öffnen Sie im Feld Connection das Dropdownfeld, und wählen Sie die vorhandene Verbindungszeichenfolge aus der Liste aus. Wählen Sie dann Speichern>Schließen aus.
Erweitern Sie optional Dateifilter , und geben Sie die folgenden Filter an:
Einstellung Feldbeschreibung Ordnerpfad Daten filtern, um Dateien mit einem bestimmten Ordnerpfad aufzunehmen. Dateierweiterung Filtert Daten, um Dateien nur mit einer bestimmten Dateierweiterung aufzunehmen. Wählen Sie im Abschnitt "Eventstream-Einstellungen" die Ereignisse aus, die in denEreignistypen "> überwacht werden sollen. Standardmäßig ist blob created ausgewählt. Sie können auch Blob umbenannt auswählen.
Wählen Sie "Weiter" aus, um eine Vorschau der Daten anzuzeigen.
Vorschaudaten vor dem Import prüfen
Die Registerkarte Untersuchen wird mit einer Vorschau der Daten geöffnet.
Um den Erfassungsprozess abzuschließen, wählen Sie Fertig stellen aus.
Anmerkung
Um kontinuierliche Aufnahme- und Vorschaudaten auszulösen, laden Sie ein neues Blob hoch, nachdem Sie die Konfiguration abgeschlossen haben.
Optionalerweise:
Verwenden Sie das Dropdownmenü der Schemadefinitionsdatei, um die Datei zu ändern, von der das Schema abgeleitet wird.
Verwenden Sie das Dropdownmenü "Dateityp", um erweiterte Optionen basierend auf dem Datentyp zu erkunden.
Verwenden Sie das Dropdown-Menü Table_mapping, um eine neue Zuordnung zu definieren.
Wählen Sie </> aus, um die Befehlsanzeige zu öffnen und die automatisch aus Ihren Eingaben generierten Befehle anzuzeigen und zu kopieren. Sie können die Befehle auch in einem KQL-Abfrageset öffnen.
Wählen Sie das Bleistiftsymbol aus, um Spalten zu bearbeiten.
Spalten bearbeiten
Anmerkung
- Bei tabellarischen Formaten (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.
- Sie können keinen vorhandenen Spaltentyp ändern. Wenn Sie versuchen, einer Spalte ein abweichendes Format zuzuordnen, könnte dies zu leeren Spalten führen.
Die Änderungen, die Sie in einer Tabelle vornehmen können, hängen von den folgenden Parametern ab:
- Tabellentyp 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 (auf der Sie dann den Datentyp ändern, sie umbenennen und aktualisieren können) |
| Vorhandene Tabelle | Vorhandene Zuordnung | nichts |
Zuordnungstransformationen
Einige 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 vom Typ "Zeichenfolge" oder "datetime" ausgeführt werden, wobei die Quelle den Datentyp "int" oder "long" aufweist. Weitere Informationen finden Sie in der vollständigen Liste der unterstützten Zuordnungstransformationen.
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. Tabellarische Daten enthalten nicht unbedingt die Spaltennamen, die zum Zuordnen von Quelldaten zu den vorhandenen Spalten verwendet werden. Wenn diese Option aktiviert ist, erfolgt die Zuordnung nach Reihenfolge, und das Tabellenschema bleibt gleich. Wenn diese Option deaktiviert ist, werden neue Spalten für eingehende Daten erstellt, unabhängig von der Datenstruktur.
Tabellarische Daten enthalten nicht unbedingt die Spaltennamen, die zum Zuordnen von Quelldaten zu den vorhandenen Spalten verwendet werden. Wählen Sie Erste Zeile ist Spaltenüberschrift aus, um die erste Zeile als Spaltennamen zu verwenden.
Tabellarisch (CSV, TSV, PSV):
Wenn Sie tabellarische Formate in einer vorhandenen Tabelle aufnehmen, wählen Sie Table_mapping>Vorhandenes Schema verwenden. Tabellarische Daten enthalten nicht unbedingt die Spaltennamen, die zum Zuordnen von Quelldaten zu den vorhandenen Spalten verwendet werden. Wenn Sie diese Option auswählen, erfolgt die Zuordnung nach Reihenfolge, und das Tabellenschema bleibt gleich. Wenn Sie diese Option deaktivieren, werden neue Spalten für eingehende Daten erstellt, unabhängig von der Datenstruktur.
Wenn Sie die erste Zeile als Spaltennamen verwenden möchten, wählen Sie die Überschrift " Erste Zeile" aus.
JSON:
Um die Spaltenteilung von JSON-Daten zu bestimmen, wählen Sie "Geschachtelte Ebenen" von 1 bis 100 aus.
Überprüfen der Erfassungszusammenfassung
Im Zusammenfassungsfenster zeigen alle Schritte grüne Häkchen an, wenn die Datenaufnahme erfolgreich abgeschlossen ist. Sie können eine Karte auswählen, um die Daten zu durchsuchen, die aufgenommenen Daten zu löschen oder ein Dashboard mit wichtigen Metriken zu erstellen.
Wenn Sie das Fenster schließen, können Sie die Verbindung auf der Registerkarte "Explorer" unter "Datenströme" sehen. Von hier aus können Sie die Datenströme filtern und einen Datenstrom löschen.
Verwandte Inhalte
- Informationen zum Verwalten Ihrer Datenbank finden Sie unter "Verwalten von Daten".
- Informationen zum Erstellen, Speichern und Exportieren von Abfragen finden Sie unter Abfragedaten in einem KQL-Abfrageset.