Flexibles Dateiziel
Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory
Die Komponente Flexibles Dateiziel ermöglicht einem SSIS-Paket das Schreiben von Daten in verschiedene unterstützte Speicherdienste.
Zurzeit unterstützte Speicherdienste:
Ziehen Sie das Flexible Dateiziel auf den Datenfluss-Designer, und doppelklicken Sie darauf, um den Editor aufzurufen.
Das Flexible Dateiziel ist eine Komponente des SQL Server Integration Services Feature Pack (SSIS) für Azure.
Die folgenden Eigenschaften stehen im Editor für das flexible Datenziel zur Verfügung.
- Typ des Verbindungs-Managers: Gibt den Typ des Quellverbindungs-Managers an. Wählen Sie einen vorhandenen Manager des angegebenen Typs aus, oder erstellen Sie einen neuen.
- Ordnerpfad: Gibt den Pfad des Zielordners an.
- Dateiname: Gibt den Namen der Zieldatei an.
- Dateiformat: Gibt das Zieldateiformat an. Unterstützte Formate sind Text, Avro, ORC, Parquet. Java ist für ORC/Parquet erforderlich. Ausführliche Informationen finden Sie hier.
- Spaltentrennzeichen: Gibt das als Trennzeichen für Spalten zu verwendende Zeichen an (Trennzeichen, die aus mehreren Zeichen bestehen, werden nicht unterstützt).
- Erste Zeile als Spaltenname: Gibt an, ob Spaltennamen in die erste Zeile geschrieben werden sollen.
- Datei komprimieren: Gibt an, ob die Datei komprimiert werden soll.
- Komprimierungstyp: Gibt das zu verwendende Komprimierungsformat an. Unterstützte Formate sind GZIP, DEFLATE, BZIP2.
- Komprimierungsgrad: Gibt den zu verwendenden Komprimierungsgrad an.
Die folgenden Eigenschaften stehen im Erweiterten Editor zur Verfügung.
- rowDelimiter: Das Zeichen, das zum Trennen von Zeilen in einer Datei verwendet wird. Es ist nur ein Zeichen zulässig. Der Standardwert ist „\r\n“.
- escapeChar: Das Sonderzeichen, mit dem ein Spaltentrennzeichen im Inhalt der Eingabedatei mit Escapezeichen versehen werden kann. Sie können nicht gleichzeitig „escapeChar“ und „quoteChar“ für eine Tabelle angeben. Es ist nur ein Zeichen zulässig. Für dieses Feld gibt es keinen Standardwert.
- quoteChar: Das Zeichen, mit dem ein Zeichenfolgenwert in Anführungszeichen gesetzt wird. Die Spalten- und Zeilentrennzeichen innerhalb der Anführungszeichen werden als Teil des Zeichenfolgenwerts behandelt. Diese Eigenschaft gilt sowohl für Eingabe- als auch Ausgabedatasets. Sie können nicht gleichzeitig „escapeChar“ und „quoteChar“ für eine Tabelle angeben. Es ist nur ein Zeichen zulässig. Für dieses Feld gibt es keinen Standardwert.
- nullValue: Ein oder mehrere Zeichen, mit denen ein NULL-Wert dargestellt wird. Der Standardwert ist „\N“.
- encodingName: Geben Sie den Codierungsnamen an. Siehe Eigenschaft Encoding.EncodingName.
- skipLineCount: Gibt die Anzahl der nicht leeren Zeilen an, die beim Lesen von Daten aus Eingabedateien übersprungen werden sollen. Wenn „skipLineCount“ und „firstRowAsHeader“ gleichzeitig angegeben sind, werden die Zeilen zuerst übersprungen, und anschließend werden die Kopfzeileninformationen aus der Eingabedatei gelesen.
- treatEmptyAsNull: Gibt an, ob Null- oder leere Zeichenfolgen beim Lesen von Daten aus einer Eingabedatei als NULL-Werte behandelt werden sollen. Der Standardwert ist True.
Nachdem Sie die Verbindungsinformationen angegeben haben, wechseln Sie zur Seite Spalten , um Quellspalten zu den Zielspalten für den SSIS-Datenfluss zuzuordnen.
Hinweise zur Konfiguration der Dienstprinzipalberechtigung
Damit die Testverbindung funktioniert (Blob Storage oder Data Lake Storage Gen2), müssen Sie dem Dienstprinzipal mindestens die Rolle Storage-Blobdatenleser zuweisen. Dies erfolgt mit der RBAC.
Für Blob Storage wird die Schreibberechtigung gewährt, indem mindestens die Rolle Mitwirkender an Storage-Blobdaten zugewiesen wird.
Für Data Lake Storage Gen2 wird die Berechtigung durch die RBAC und ACLs bestimmt. Beachten Sie, dass ACLs wie hier beschrieben mithilfe der Objekt-ID (OID) des Dienstprinzipals für die App-Registrierung konfiguriert werden. Dies unterscheidet sich von der Anwendungs-ID (Client-ID), die mit der RBAC-Konfiguration verwendet wird. Wenn ein Sicherheitsprinzipal durch eine integrierte Rolle oder eine benutzerdefinierte Rolle RBAC-Datenberechtigungen erhält, werden diese Berechtigungen vor der Autorisierung einer Anforderung zunächst ausgewertet. Wenn der Anforderungsvorgang von den RBAC-Zuweisungen des Sicherheitsprinzipals autorisiert wurde, wird die Autorisierung sofort aufgelöst, und es werden keine weiteren ACL-Prüfungen durchgeführt. Wenn der Sicherheitsprinzipal über keine RBAC-Zuweisung verfügt oder der Vorgang der Anforderung nicht mit der zugewiesenen Berechtigung übereinstimmt, werden alternativ ACL-Prüfungen durchgeführt, um zu bestimmen, ob der Sicherheitsprinzipal für die Durchführung des angeforderten Vorgangs autorisiert ist. Für die Schreibberechtigung müssen Sie mindestens die Berechtigung Execute (Ausführen) ab dem Senkedateisystem sowie die Berechtigung Write (Schreiben) für den Senkeordner gewähren. Gewähren Sie alternativ mindestens die Rolle Storage Blob Data Contributor (Mitwirkender an Storage-Blobdaten) mit der RBAC. Weitere Informationen finden Sie in diesem Artikel.