Flexibles DateizielFlexible File Destination

GILT FÜR: JaSQL Server JaAzure SSIS Integration Runtime in Azure Data FactoryAPPLIES TO: YesSQL Server YesSSIS Integration Runtime in Azure Data Factory

Die Komponente Flexibles Dateiziel ermöglicht einem SSIS-Paket das Schreiben von Daten in verschiedene unterstützte Speicherdienste.The Flexible File Destination component enables an SSIS package to write data to various supported storage services.

Zurzeit unterstützte Speicherdienste:Currently supported storage services are

Ziehen Sie das Flexible Dateiziel auf den Datenfluss-Designer, und doppelklicken Sie darauf, um den Editor aufzurufen.Drag-drop Flexible File Destination to the data flow designer and double-click it to see the editor.

Das Flexible Dateiziel ist eine Komponente des SQL Server Integration Services Feature Pack (SSIS) für Azure.The Flexible File Destination is a component of the SQL Server Integration Services (SSIS) Feature Pack for Azure.

Die folgenden Eigenschaften stehen im Editor für das flexible Datenziel zur Verfügung.Following properties are available on the Flexible File Destination Editor.

  • Typ des Verbindungs-Managers: Gibt den Typ des Quellverbindungs-Managers an.File Connection Manager Type: Specifies the source connection manager type. Wählen Sie einen vorhandenen Manager des angegebenen Typs aus, oder erstellen Sie einen neuen.Then choose an existing one of the specified type or create a new one.
  • Ordnerpfad: Gibt den Pfad des Zielordners an.Folder Path: Specifies the destination folder path.
  • Dateiname: Gibt den Namen der Zieldatei an.File Name: Specifies the destination file name.
  • Dateiformat: Gibt das Zieldateiformat an.File Format: Specifies the destination file format. Unterstützte Formate sind Text, Avro, ORC, Parquet.Supported formats are Text, Avro, ORC, Parquet. Java ist für ORC/Parquet erforderlich.Java is required for ORC/Parquet. Ausführliche Informationen finden Sie hier.See here for details.
  • Spaltentrennzeichen: Gibt das als Trennzeichen für Spalten zu verwendende Zeichen an (Trennzeichen, die aus mehreren Zeichen bestehen, werden nicht unterstützt).Column delimiter character: Specifies the character to use as column delimiter (multi-character delimiters are not supported).
  • Erste Zeile als Spaltenname: Gibt an, ob Spaltennamen in die erste Zeile geschrieben werden sollen.First row as the column name: Specifies whether to write column names to first row.
  • Datei komprimieren: Gibt an, ob die Datei komprimiert werden soll.Compress the file: Specifies whether to compress the file.
  • Komprimierungstyp: Gibt das zu verwendende Komprimierungsformat an.Compression Type: Specifies the compression format to use. Unterstützte Formate sind GZIP, DEFLATE, BZIP2.Supported formats are GZIP, DEFLATE, BZIP2.
  • Komprimierungsgrad: Gibt den zu verwendenden Komprimierungsgrad an.Compression Level: Specifies the compression level to use.

Die folgenden Eigenschaften stehen im Erweiterten Editor zur Verfügung.Following properties are available on the Advanced Editor.

  • rowDelimiter: Das Zeichen, das zum Trennen von Zeilen in einer Datei verwendet wird.rowDelimiter: The character used to separate rows in a file. Es ist nur ein Zeichen zulässig.Only one character is allowed. Der Standardwert ist „\r\n“.The default value is \r\n.
  • escapeChar: Das Sonderzeichen, mit dem ein Spaltentrennzeichen im Inhalt der Eingabedatei mit Escapezeichen versehen werden kann.escapeChar: The special character used to escape a column delimiter in the content of input file. Sie können nicht gleichzeitig „escapeChar“ und „quoteChar“ für eine Tabelle angeben.You cannot specify both escapeChar and quoteChar for a table. Es ist nur ein Zeichen zulässig.Only one character is allowed. Für dieses Feld gibt es keinen Standardwert.No default value.
  • quoteChar: Das Zeichen, mit dem ein Zeichenfolgenwert in Anführungszeichen gesetzt wird.quoteChar: The character used to quote a string value. Die Spalten- und Zeilentrennzeichen innerhalb der Anführungszeichen werden als Teil des Zeichenfolgenwerts behandelt.The column and row delimiters inside the quote characters would be treated as part of the string value. Diese Eigenschaft gilt sowohl für Eingabe- als auch Ausgabedatasets.This property is applicable to both input and output datasets. Sie können nicht gleichzeitig „escapeChar“ und „quoteChar“ für eine Tabelle angeben.You cannot specify both escapeChar and quoteChar for a table. Es ist nur ein Zeichen zulässig.Only one character is allowed. Für dieses Feld gibt es keinen Standardwert.No default value.
  • nullValue: Ein oder mehrere Zeichen, mit denen ein NULL-Wert dargestellt wird.nullValue: One or more characters used to represent a null value. Der Standardwert ist „\N“.The default value is \N.
  • encodingName: Geben Sie den Codierungsnamen an.encodingName: Specify the encoding name. Siehe Eigenschaft Encoding.EncodingName.See Encoding.EncodingName Property.
  • skipLineCount: Gibt die Anzahl der nicht leeren Zeilen an, die beim Lesen von Daten aus Eingabedateien übersprungen werden sollen.skipLineCount: Indicates the number of non-empty rows to skip when reading data from input files. Wenn „skipLineCount“ und „firstRowAsHeader“ gleichzeitig angegeben sind, werden die Zeilen zuerst übersprungen, und anschließend werden die Kopfzeileninformationen aus der Eingabedatei gelesen.If both skipLineCount and firstRowAsHeader are specified, the lines are skipped first and then the header information is read from the input file.
  • treatEmptyAsNull: Gibt an, ob Null- oder leere Zeichenfolgen beim Lesen von Daten aus einer Eingabedatei als NULL-Werte behandelt werden sollen.treatEmptyAsNull: Specifies whether to treat null or empty string as a null value when reading data from an input file. Der Standardwert ist True.The default value is True.

Nachdem Sie die Verbindungsinformationen angegeben haben, wechseln Sie zur Seite Spalten , um Quellspalten zu den Zielspalten für den SSIS-Datenfluss zuzuordnen.After specifying the connection information, switch to the Columns page to map source columns to destination columns for the SSIS data flow.

Hinweise zur Konfiguration der DienstprinzipalberechtigungNotes on Service Principal Permission Configuration

Damit die Testverbindung funktioniert (Blob Storage oder Data Lake Storage Gen2), müssen Sie dem Dienstprinzipal mindestens die Rolle Storage-Blobdatenleser zuweisen.For Test Connection to work (either blob storage or Data Lake Storage Gen2), the service principal should be assigned at least Storage Blob Data Reader role to the storage account. Dies erfolgt mit der RBAC.This is done with RBAC.

Für Blob Storage wird die Schreibberechtigung gewährt, indem mindestens die Rolle Mitwirkender an Storage-Blobdaten zugewiesen wird.For blob storage, write permission is granted by assigning at least Storage Blob Data Contributor role.

Für Data Lake Storage Gen2 wird die Berechtigung durch die RBAC und ACLs bestimmt.For Data Lake Storage Gen2, permission is determined by both RBAC and ACLs. Beachten Sie, dass ACLs wie hier beschrieben mithilfe der Objekt-ID (OID) des Dienstprinzipals für die App-Registrierung konfiguriert werden.Pay attention that ACLs are configured using the Object ID (OID) of the service principal for the app registration as detailed here. Dies unterscheidet sich von der Anwendungs-ID (Client-ID), die mit der RBAC-Konfiguration verwendet wird.This is different from the Application (client) ID that is used with RBAC configuration. 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.When a security principal is granted RBAC data permissions through a built-in role, or through a custom role, these permissions are evaluated first upon authorization of a request. 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.If the requested operation is authorized by the security principal's RBAC assignments, then authorization is immediately resolved and no additional ACL checks are performed. 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.Alternatively, if the security principal does not have an RBAC assignment, or the request's operation does not match the assigned permission, then ACL checks are performed to determine if the security principal is authorized to perform the requested operation. 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.For write permission, grant at least Execute permission starting from the sink file system, along with Write permission for the sink folder. Gewähren Sie alternativ mindestens die Rolle Storage Blob Data Contributor (Mitwirkender an Storage-Blobdaten) mit der RBAC.Alternatively, grant at least the Storage Blob Data Contributor role with RBAC. Weitere Informationen finden Sie in diesem Artikel.See this article for details.