- Artikel
In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität in der Datenpipeline verwenden, um Daten aus und in Azure Blob Storage zu kopieren.
Wichtig
Microsoft Fabric befindet sich derzeit in der Vorschauversion.Diese Informationen beziehen sich auf eine Vorabversion des Produkts, an der vor der Veröffentlichung noch wesentliche Änderungen vorgenommen werden können. Microsoft übernimmt keine Garantie, weder ausdrücklich noch stillschweigend, für die hier bereitgestellten Informationen. Weitere Informationen finden Sie in Azure Data Factory Dokumentation für den Dienst in Azure.
Unterstütztes Format:
Azure Blob Storage unterstützt die folgenden Dateiformate. Informationen zu formatbasierten Einstellungen finden Sie in den jeweiligen Artikeln.
- Avro-Format
- Binärformat
- Textformat mit Trennzeichen
- Excel-Format
- JSON-Format
- ORC-Format
- Parquet-Format
- XML-Format
Unterstützte Konfiguration
Für die Konfiguration der einzelnen Registerkarten unter kopieraktivität wechseln Sie zu den folgenden Abschnitten.
- Allgemein
- Quelle
- Ziel
- Zuordnung
- Einstellungen
Allgemein
Informationen zum Konfigurieren der Registerkarte Allgemeine Einstellungen finden Sie unter Allgemeine Einstellungen.
Quelle
Die folgenden Eigenschaften werden für Azure Blob Storage auf der Registerkarte Quelle einer Kopieraktivität unterstützt.
Die folgenden Eigenschaften sind erforderlich:
- Datenspeichertyp: Wählen Sie Extern aus.
- Verbindung: Wählen Sie eine Azure Blob Storage Verbindung aus der Verbindungsliste aus. Wenn keine Verbindung vorhanden ist, erstellen Sie eine neue Azure Blob Storage Verbindung, indem Sie Neu auswählen.
- Dateipfad: Wählen Sie Durchsuchen aus, um die Datei auszuwählen, die Sie kopieren möchten, oder geben Sie den Pfad manuell ein.
- Dateieinstellungen: Wählen Sie Dateieinstellungen aus, um das Dateiformat zu konfigurieren. Ausführliche Informationen zu Einstellungen verschiedener Dateiformate finden Sie in den Artikeln unter Unterstütztes Format .
Unter Erweitert können Sie die folgenden Felder angeben:
Dateipfadtyp: Sie können Dateipfad, Präfix, Feldhalterdateipfad, Liste der Dateien als Dateipfadtyp auswählen. Die Konfiguration jeder Einstellung lautet:
Dateipfad: Wenn Sie diesen Typ auswählen, können die Daten aus dem zuvor angegebenen Container- oder Ordner-/Dateipfad kopiert werden.
Präfix: Präfix für den Blobnamen unter dem angegebenen Container, der zum Filtern von Quellblobs konfiguriert ist. Es werden die Blobs ausgewählt, deren Namen mit
container/this_prefixbeginnen. Es verwendet den dienstseitigen Filter für Blobspeicher.Wenn Sie Präfix verwenden und in ein dateibasiertes Ziel mit beibehaltener Hierarchie kopieren möchten, wird der Unterpfad nach dem letzten "/" im Präfix beibehalten. Beispielsweise verfügen Sie über eine Quelle
container/folder/subfolder/file.txtund konfigurieren das Präfix alsfolder/sub. Der Dateipfad istsubfolder/file.txtbeibehalten.
Pfad der Feldhalterdatei: Geben Sie den Ordner oder Dateipfad mit Denkzeichen unter Dem angegebenen Blobcontainer an, um Ihre Quellordner oder -dateien zu filtern.
Folgende Platzhalter sind zulässig:
*(entspricht null [0] oder mehr Zeichen) und?(entspricht null [0] oder einem einzelnen Zeichen). Verwenden Sie^als Escapezeichen, wenn Ihr Ordnername einen Platzhalter oder dieses Escapezeichen enthält. Weitere Beispiele findest du unter Beispiele für Ordner- und Dateifilter.Pfad des Feldhalterordners: Geben Sie den Ordnerpfad mit Feldhalterzeichen unter dem angegebenen Container an, um Quellordner zu filtern.
Name der Feldhalterdatei: Geben Sie den Dateinamen mit Feldhalterzeichen unter Dem angegebenen Container- und Ordnerpfad (oder Den Ordnerpfad) an, um Quelldateien zu filtern.
Liste der Dateien: Gibt einen bestimmten Dateisatz an, in den kopiert werden soll. Geben Sie unter Pfad zur Dateiliste eine Textdatei ein, oder navigieren Sie zu einer Textdatei, die eine Liste der dateien enthält, die Sie kopieren möchten, eine Datei pro Zeile. Dies ist der relative Pfad zu jeder Datei.
Wenn Sie diese Option verwenden, geben Sie keinen Dateinamen an. Weitere Beispiele findest du unter Beispiele für Dateilisten.
Rekursiv: Wenn dieses Kontrollkästchen aktiviert ist, werden alle Dateien im Eingabeordner und seinen Unterordnern rekursiv verarbeitet. Wenn Sie das Kontrollkästchen deaktivieren, werden nur die Im ausgewählten Ordner verarbeitet. Diese Einstellung ist deaktiviert, wenn eine einzelne Datei ausgewählt wird.
Dateien nach Abschluss löschen: Wenn dieses Kontrollkästchen aktiviert ist, werden die Binärdateien nach dem erfolgreichen Wechsel in den Zielspeicher aus dem Quellspeicher gelöscht. Das Löschen der Datei erfolgt pro Datei. Wenn also die Kopieraktivität fehlschlägt, werden Sie feststellen, dass einige Dateien bereits an das Ziel kopiert und aus der Quelle gelöscht wurden, während andere weiterhin im Quellspeicher verbleiben.
Hinweis
Diese Eigenschaft ist nur in einem Szenario zum Kopieren von Binärdateien gültig.
Max. gleichzeitige Verbindungen: Diese Eigenschaft gibt die Obergrenze der gleichzeitigen Verbindungen an, die während der Aktivitätsausführung mit dem Datenspeicher eingerichtet wurden. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten.
Destination
Die folgenden Eigenschaften werden für Azure Blob Storage auf der Registerkarte Ziel einer Kopieraktivität unterstützt.
Die folgenden Eigenschaften sind erforderlich:
- Datenspeichertyp: Wählen Sie Extern aus.
- Verbindung: Wählen Sie eine Azure Blob Storage Verbindung aus der Verbindungsliste aus. Wenn die Verbindung nicht vorhanden ist, erstellen Sie eine neue Azure Blob Storage Verbindung, indem Sie Neu auswählen.
- Dateipfad: Wählen Sie Durchsuchen aus, um die Datei auszuwählen, die Sie kopieren oder den Pfad manuell ausfüllen möchten.
- Dateieinstellungen: Wählen Sie Dateieinstellungen aus, um das Dateiformat zu konfigurieren. Ausführliche Informationen zu Einstellungen verschiedener Dateiformate finden Sie in den Artikeln unter Unterstütztes Format .
Unter Erweitert können Sie die folgenden Felder angeben:
Kopierverhalten: Definiert das Kopierverhalten, wenn die Quelle Dateien aus einem dateibasierten Datenspeicher ist. Sie können dynamischen Inhalt hinzufügen, Keine, FlattenHierarchy oder Hierarchie beibehalten in der Dropdownliste auswählen.
Dynamischen Inhalt hinzufügen: Um einen Ausdruck für einen Eigenschaftswert anzugeben, wählen Sie Dynamischen Inhalt hinzufügen aus. Diese Auswahl öffnet den Ausdrucks-Generator, in dem Sie Ausdrücke aus unterstützten Systemvariablen, Aktivitätsausgaben, Funktionen und benutzerdefinierten Variablen oder Parametern erstellen können. Informationen zur Ausdruckssprache findest du unter Ausdrücke und Funktionen.
Keine: Wählen Sie diese Auswahl aus, um kein Kopierverhalten zu verwenden.
Flache Hierarchie: Alle Dateien aus dem Quellordner befinden sich in der ersten Ebene des Zielordners. Die Zieldateien verfügen über automatisch generierte Namen.
Hierarchie beibehalten: Behält die Dateihierarchie im Zielordner bei. Der relative Pfad der Quelldatei zum Quellordner entspricht dem relativen Pfad der Zieldatei zum Zielordner.
Maximale Anzahl gleichzeitiger Verbindungen: Die Obergrenze für gleichzeitige Verbindungen, die während der Aktivitätsausführung mit dem Datenspeicher eingerichtet wurden. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten.
Blockgröße (MB): Geben Sie die Blockgröße in Megabyte an, die zum Schreiben von Daten in Blockblobs verwendet wird. Weitere Informationen findest du unter Informationen zu Blockblobs.
Metadaten: Legen Sie benutzerdefinierte Metadaten beim Kopieren in ein Ziel fest. Jedes Objekt unter dem Array
metadatastellt eine zusätzliche Spalte dar.namedefiniert den Namen des Metadatenschlüssels, undvaluegibt den Datenwert dieses Schlüssels an. Wenn dasFeature "Attribute beibehalten" verwendet wird, werden die angegebenen Metadaten mit den Metadaten der Quelldatei zusammen-/überschrieben.Zulässige Datenwerte sind:
$$LASTMODIFIED: Eine reservierte Variable gibt an, dass der Zeitpunkt der letzten Änderung der Quelldateien gespeichert werden soll. Gilt nur für dateibasierte Quellen im Binärformat.Ausdruck
Statischer Wert
Zuordnung
Wechseln Sie unter Konfiguration der Registerkarte Zuordnung auf der Registerkarte Zuordnung zu Konfigurieren Ihrer Zuordnungen. Wenn Sie Binär als Dateiformat auswählen, wird die Zuordnung nicht unterstützt.
Einstellungen
Informationen zur Konfiguration der Registerkarte "Einstellungen " finden Sie unter Konfigurieren ihrer anderen Einstellungen auf der Registerkarte "Einstellungen".
Tabellenzusammenfassung
Die folgenden Tabellen enthalten weitere Informationen zur Kopieraktivität in Azure Blob Storage.
Quellinformationen
| Name | BESCHREIBUNG | Wert | Erforderlich | JSON-Skripteigenschaft |
|---|---|---|---|---|
| Datenspeichertyp | Ihr Datenspeichertyp. | Extern | Yes | / |
| Connection | Ihre Verbindung mit dem Quelldatenspeicher. | <Ihre Verbindung> | Yes | connection |
| Dateipfad | Der Dateipfad Ihrer Quelldaten. | <Dateipfad Ihrer Quelle> | Ja | Container fileName |
| Dateipfadtyp | Der Dateipfadtyp, den Sie verwenden möchten. | • Dateipfad •Präfix • Pfad des Wildcard-Ordners, Name der Wildcard-Datei • Liste der Dateien | No | •Präfix • wildcardFolderPath, wildcardFileName • fileListPath |
| Rekursiv | Verarbeiten Sie alle Dateien im Eingabeordner und seinen Unterordnern rekursiv oder nur die Dateien im ausgewählten Ordner. Diese Einstellung wird deaktiviert, wenn eine einzelne Datei ausgewählt wird. | Auswahl oder Aufheben der Auswahl | No | recursive |
| Löschen von Dateien nach Abschluss | Die Dateien im Quelldatenspeicher werden direkt nach dem Verschieben in den Zielspeicher gelöscht. Die Datei wird pro Datei gelöscht. Wenn also eine Kopieraktivität fehlschlägt, werden Sie feststellen, dass einige Dateien bereits in das Ziel kopiert und aus der Quelle gelöscht wurden, während sich andere noch im Quellspeicher befinden. | Auswahl oder Aufheben der Auswahl | Nein | deleteFilesAfterCompletion |
| Maximale Anzahl gleichzeitiger Verbindungen | Die Obergrenze gleichzeitiger Verbindungen mit dem Datenspeicher während der Aktivitätsausführung. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten. | <Max. gleichzeitige Verbindungen> | Nein | maxConcurrentConnections |
Zielinformationen
| Name | BESCHREIBUNG | Wert | Erforderlich | JSON-Skripteigenschaft |
|---|---|---|---|---|
| Datenspeichertyp | Ihr Datenspeichertyp. | Extern | Yes | / |
| Connection | Ihre Verbindung mit dem Zieldatenspeicher. | <Ihre Verbindung> | Yes | connection |
| Dateipfad | Der Dateipfad Ihrer Zieldaten. | Dateipfad der Quelle | Ja | Container fileName |
| Kopierverhalten | Definiert das Verhalten beim Kopieren von Dateien aus einem Dateisystem, z. B. Speicher, in das andere (z. B. von einem Blobspeicher in ein anderes). | •Nichts • Hinzufügen dynamischer Inhalte • Vereinfachen der Hierarchie • Hierarchie beibehalten | No | copyBehavior |
| Maximale Anzahl gleichzeitiger Verbindungen | Die Obergrenze gleichzeitiger Verbindungen mit dem Datenspeicher während der Aktivitätsausführung. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten. | <Max. gleichzeitige Verbindungen> | Nein | maxConcurrentConnections |
| Blockgröße (MB) | Geben Sie beim Schreiben von Daten in Azure Blob Storage die Blockgröße in MB an. Der zulässige Wert liegt zwischen 4 und 100MB. | <Blockgröße> | Nein | blockSizeInMB |
| Metadaten | Legen Sie die benutzerdefinierten Metadaten beim Kopieren in das Ziel fest. | • $$LASTMODIFIED•Ausdruck • Statischer Wert | Nein | metadata |
Nächste Schritte
- Erstellen einer Azure Blob-Verbindung
- Herstellen einer Verbindung mit Azure Blob Storage in Dataflows]