Skip to content

Commit aa78a25

Browse files
committed
Add use temp file rename option for SFTP connector
1 parent c0527fc commit aa78a25

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

articles/data-factory/connector-sftp.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.service: data-factory
1111
ms.workload: data-services
1212
ms.topic: conceptual
1313
ms.custom: seo-lt-2019
14-
ms.date: 12/12/2019
14+
ms.date: 03/02/2020
1515
---
1616

1717
# Copy data from and to SFTP server using Azure Data Factory
@@ -282,8 +282,12 @@ The following properties are supported for SFTP under `storeSettings` settings i
282282
| type | The type property under `storeSettings` must be set to **SftpWriteSettings**. | Yes |
283283
| copyBehavior | Defines the copy behavior when the source is files from a file-based data store.<br/><br/>Allowed values are:<br/><b>- PreserveHierarchy (default)</b>: Preserves the file hierarchy in the target folder. The relative path of the source file to the source folder is identical to the relative path of the target file to the target folder.<br/><b>- FlattenHierarchy</b>: All files from the source folder are in the first level of the target folder. The target files have autogenerated names. <br/><b>- MergeFiles</b>: Merges all files from the source folder to one file. If the file name is specified, the merged file name is the specified name. Otherwise, it's an autogenerated file name. | No |
284284
| maxConcurrentConnections | The number of connections to connect to the data store concurrently. Specify only when you want to limit the concurrent connection to the data store. | No |
285+
| useTempFileRename | Indicate whether to upload to temporary file(s) and rename, or directly write to the target folder/file location. By default, ADF firstly write to temporary file(s) then do file rename upon upload completion, in order to 1) avoid conflict write resulting in corrupted file if you have other process writing to the same file, and 2) ensure the original version of the file exists during whole transfer. If your SFTP server doesn't support rename operation, disable this option and make sure you don't have concurrent write to the target file. See troubleshooting tip below this table. | No. Default value is true. |
285286
| operationTimeout | The wait time before each write request to SFTP server times out. Default value is 60 min (01:00:00).|No |
286287

288+
>[!TIP]
289+
>If you hit error of "UserErrorSftpPathNotFound", "UserErrorSftpPermissionDenied" or "SftpOperationFail" when writing data into SFTP, and the SFTP user you use does have the proper permission, check if your SFTP server support file rename operation - if not, disable "Upload with temp file" (`useTempFileRename`) option and try again. Learn more about this property from above table. If you use Self-hosted Integration Runtime for copy, make sure you use version 4.6 or above.
290+
287291
**Example:**
288292

289293
```json

0 commit comments

Comments
 (0)