Flexibler DateitaskFlexible File Task

Anwendungsbereich:Applies to: Ja SQL ServerSQL Server (alle unterstützten Versionen)yesSQL ServerSQL Server (all supported versions) Ja SSIS-Integrationslaufzeit in Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS-Integrationslaufzeit in Azure Data FactorySSIS Integration Runtime in Azure Data FactoryAnwendungsbereich:Applies to: Ja SQL ServerSQL Server (alle unterstützten Versionen)yesSQL ServerSQL Server (all supported versions) Ja SSIS-Integrationslaufzeit in Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS-Integrationslaufzeit in Azure Data FactorySSIS Integration Runtime in Azure Data Factory

Der flexible Dateitask ermöglicht Benutzern das Ausführen von Dateivorgängen für verschiedene unterstützte Speicherdienste.The Flexible File Task enables users to perform file operations on various supported storage services. Zurzeit unterstützte Speicherdienste:Currently supported storage services are

Der flexible Dateitask ist eine Komponente des SQL Server Integration Services Feature Pack (SSIS) für Azure.The Flexible File Task is a component of the SQL Server Integration Services (SSIS) Feature Pack for Azure.

Ziehen Sie den flexiblen Dateitask aus der SSIS-Toolbox auf die Designercanvas, um diesen einem Paket hinzuzufügen.To add a Flexible File Task to a package, drag it from SSIS Toolbox to the designer canvas. Doppelklicken Sie anschließend auf den Task, oder klicken Sie mit der rechten Maustaste darauf, und klicken Sie auf Bearbeiten, um das Dialogfeld Flexibler Dateitask-Editor zu öffnen.Then double-click the task, or right-click the task and select Edit, to open the Flexible File Task Editor dialog box.

Mit der Operation-Eigenschaft wird der auszuführende Dateivorgang angegeben.The Operation property specifies the file operation to perform. Zurzeit werden folgende Vorgänge unterstützt:Currently supported operations are:

  • KopiervorgangCopy Operation
  • LöschvorgangDelete Operation

Die folgenden Eigenschaften sind für den Kopiervorgang verfügbar.For Copy operation, following properties are available.

  • SourceConnectionType: Gibt den Typ des Quellverbindungs-Managers an.SourceConnectionType: Specifies the source connection manager type.
  • SourceConnection: Gibt den Quellverbindungs-Manager an.SourceConnection: Specifies the source connection manager.
  • SourceFolderPath: Gibt den Pfad des Quellordners an.SourceFolderPath: Specifies the source folder path.
  • SourceFileName: Gibt den Namen der Quelldatei an.SourceFileName: Specifies the source file name. Wenn diese Angabe leer gelassen wird, wird der Quellordner kopiert.If left blank, the source folder will be copied. Folgende Platzhalter dürfen im Quelldateinamen verwendet werden: * (entspricht 0 (Null) oder mehr Zeichen), ? (entspricht 0 (Null) oder einem Zeichen) und ^ (Escapezeichen).Following wildcards are allowed in source file name: * (matches zero or more characters), ? (matches zero or single character) and ^ (escape character).
  • SearchRecursively: Gibt an, ob Unterordner rekursiv kopiert werden sollen.SearchRecursively: Specifies whether to recursively copy subfolders.
  • DestinationConnectionType: Gibt den Typ des Zielverbindungs-Managers an.DestinationConnectionType: Specifies the destination connection manager type.
  • DestinationConnection: Gibt den Zielverbindungs-Manager an.DestinationConnection: Specifies the destination connection manager.
  • DestinationFolderPath: Gibt den Pfad des Zielordners an.DestinationFolderPath: Specifies the destination folder path.
  • DestinationFileName: Gibt den Namen der Zieldatei an.DestinationFileName: Specifies the destination file name. Wenn diese Angabe leer gelassen wird, werden die Namen der Quelldatei verwendet.If left blank, the source file names will be used.

Die folgenden Eigenschaften sind für den Löschvorgang verfügbar.For Delete operation, following properties are available.

  • ConnectionType: Gibt den Typ des Verbindungs-Managers an.ConnectionType: Specifies the connection manager type.
  • Connection: Gibt den Verbindungs-Manager an.Connection: Specifies the connection manager.
  • FolderPath: Gibt den Ordnerpfad an.FolderPath: Specifies the folder path.
  • FileName: Gibt den Dateinamen an.FileName: Specifies the file name. Wenn diese Angabe leer gelassen wird, wird der Ordner gelöscht.If left blank, the folder will be deleted. Für Azure Blob Storage wird das Löschen des Ordners nicht unterstützt.For Azure Blob Storage, delete folder is not supported. Folgende Platzhalter dürfen im Dateinamen verwendet werden: * (entspricht 0 (Null) oder mehr Zeichen), ? (entspricht 0 (Null) oder einem Zeichen) und ^ (Escapezeichen).Following wildcards are allowed in file name: * (matches zero or more characters), ? (matches zero or single character) and ^ (escape character).
  • DeleteRecursively: Gibt an, ob Dateien rekursiv gelöscht werden sollenDeleteRecursively: Specifies whether to recusively delete files.

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.

Blob-Speicher-, Lese- und Schreibberechtigungen werden durch das Zuweisen der jeweiligen Storage Blob Data Reader- (Storage-Blobdatenleser) und Storage Blob Data Contributor-Rollen (Mitwirkender an Storage-Blobdaten) gewährt.For blob storage, read and write permissions are granted by assigning at least Storage Blob Data Reader and Storage Blob Data Contributor roles, respectively.

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 Leseberechtigung müssen Sie mindestens die Berechtigung Execute (Ausführen) ab dem Quelldateisystem sowie die Berechtigung Read (Lesen) für die zu kopierenden Dateien gewähren.For read permission, grant at least Execute permission starting from the source file system, along with Read permission for the files to copy. Gewähren Sie alternativ mindestens die Rolle Storage-Blobdatenleser mit der RBAC.Alternatively, grant at least the Storage Blob Data Reader role with RBAC.
  • 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.