你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

AdlsClient.BulkUpload 方法

定义

重载

BulkUpload(String, String, Int32, IfExists, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken)

将目录或文件从本地上传到远程。 传输目标目录下的源目录下的内容。 传输源文件并将其保存为目标路径。 此方法不会对任何条目的传输失败引发任何异常。 请参阅返回值 TransferStatus ,获取每个条目的传输状态/异常。 强烈建议在创建 AdlsClient 的任何实例之前,将 ServicePointManager.DefaultConnectionLimit 设置为应用程序希望 sdk 使用的线程数。 默认情况下,ServicePointManager.DefaultConnectionLimit 设置为 2。 默认情况下,文件在新的线边界上传。 但是,如果文件在 4MB 区块内没有换行符,则传输将失败。 在这种情况下,需要将 true isBinary 传递给 以避免在换行符边界处上传。

BulkUpload(String, String, Int32, IfExists, Boolean, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken)

将目录或文件从本地上传到远程。 传输目标目录下的源目录下的内容。 传输源文件并将其保存为目标路径。 此方法不会对任何条目的传输失败引发任何异常。 请参阅返回值 TransferStatus ,获取每个条目的传输状态/异常。 默认情况下,将传输进度记录在系统临时路径中,以便用户可以在上传失败时使用 resume 进行恢复。 可以使用 禁用 disableTransferLogging此进度日志记录。 强烈建议在创建 AdlsClient 的任何实例之前,将 ServicePointManager.DefaultConnectionLimit 设置为应用程序希望 sdk 使用的线程数。 默认情况下,ServicePointManager.DefaultConnectionLimit 设置为 2。 默认情况下,文件在新的线边界上传。 但是,如果文件在 4MB 区块内没有换行符,则传输将失败。 在这种情况下,需要将 true isBinary 传递给 以避免在换行符边界处上传。

BulkUpload(String, String, Int32, IfExists, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken)

将目录或文件从本地上传到远程。 传输目标目录下的源目录下的内容。 传输源文件并将其保存为目标路径。 此方法不会对任何条目的传输失败引发任何异常。 请参阅返回值 TransferStatus ,获取每个条目的传输状态/异常。 强烈建议在创建 AdlsClient 的任何实例之前,将 ServicePointManager.DefaultConnectionLimit 设置为应用程序希望 sdk 使用的线程数。 默认情况下,ServicePointManager.DefaultConnectionLimit 设置为 2。 默认情况下,文件在新的线边界上传。 但是,如果文件在 4MB 区块内没有换行符,则传输将失败。 在这种情况下,需要将 true isBinary 传递给 以避免在换行符边界处上传。

public virtual Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus BulkUpload (string srcPath, string destPath, int numThreads = -1, Microsoft.Azure.DataLake.Store.IfExists shouldOverwrite = Microsoft.Azure.DataLake.Store.IfExists.Overwrite, IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> progressTracker = default, bool notRecurse = false, bool resume = false, bool isBinary = false, System.Threading.CancellationToken cancelToken = default);
abstract member BulkUpload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
override this.BulkUpload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
Public Overridable Function BulkUpload (srcPath As String, destPath As String, Optional numThreads As Integer = -1, Optional shouldOverwrite As IfExists = Microsoft.Azure.DataLake.Store.IfExists.Overwrite, Optional progressTracker As IProgress(Of TransferStatus) = Nothing, Optional notRecurse As Boolean = false, Optional resume As Boolean = false, Optional isBinary As Boolean = false, Optional cancelToken As CancellationToken = Nothing) As TransferStatus

参数

srcPath
String

本地源路径

destPath
String

远程目标路径 - 它应始终是目录。

numThreads
Int32

线程数 - 如果未传递,则采用默认线程数 (物理核心数的 8 倍)

shouldOverwrite
IfExists

如果目标存在,则是否覆盖或跳过

progressTracker
IProgress<TransferStatus>

用于跟踪文件传输进度的进度跟踪器

notRecurse
Boolean

如果为 true,则执行枚举,直到级别 1,否则执行递归枚举

resume
Boolean

如果为 true,则我们希望从上次传输恢复

isBinary
Boolean

如果为 false,则会在换行符边界处将文件写入数据湖,但如果文件在 4MB 区块内没有换行符,则会引发异常。 如果为 true,则不会在新行边界处上传,但上传速度更快。 默认情况下为 false,如果文件在 4MB 区块内没有换行符,则应将 true

cancelToken
CancellationToken

取消令牌

返回

封装上传详细信息的传输状态

适用于

BulkUpload(String, String, Int32, IfExists, Boolean, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken)

将目录或文件从本地上传到远程。 传输目标目录下的源目录下的内容。 传输源文件并将其保存为目标路径。 此方法不会对任何条目的传输失败引发任何异常。 请参阅返回值 TransferStatus ,获取每个条目的传输状态/异常。 默认情况下,将传输进度记录在系统临时路径中,以便用户可以在上传失败时使用 resume 进行恢复。 可以使用 禁用 disableTransferLogging此进度日志记录。 强烈建议在创建 AdlsClient 的任何实例之前,将 ServicePointManager.DefaultConnectionLimit 设置为应用程序希望 sdk 使用的线程数。 默认情况下,ServicePointManager.DefaultConnectionLimit 设置为 2。 默认情况下,文件在新的线边界上传。 但是,如果文件在 4MB 区块内没有换行符,则传输将失败。 在这种情况下,需要将 true isBinary 传递给 以避免在换行符边界处上传。

public virtual Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus BulkUpload (string srcPath, string destPath, int numThreads, Microsoft.Azure.DataLake.Store.IfExists shouldOverwrite, bool disableTransferLogging, IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> progressTracker, bool notRecurse, bool resume, bool isBinary, System.Threading.CancellationToken cancelToken);
abstract member BulkUpload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * bool * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
override this.BulkUpload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * bool * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
Public Overridable Function BulkUpload (srcPath As String, destPath As String, numThreads As Integer, shouldOverwrite As IfExists, disableTransferLogging As Boolean, progressTracker As IProgress(Of TransferStatus), notRecurse As Boolean, resume As Boolean, isBinary As Boolean, cancelToken As CancellationToken) As TransferStatus

参数

srcPath
String

本地源路径

destPath
String

远程目标路径 - 它应始终是目录。

numThreads
Int32

线程数 - 默认 -1,如果未传递,则采用默认线程数 (物理核心数的 8 倍)

shouldOverwrite
IfExists

如果目标存在,则是否要覆盖或跳过,默认 IfExists.Overwrite

disableTransferLogging
Boolean

如果为 true,则禁用传输进度的日志记录。 这 和 resume 不能同时为 true。 默认值 false

progressTracker
IProgress<TransferStatus>

用于跟踪文件传输进度的进度跟踪器,默认为 null

notRecurse
Boolean

如果为 true,则执行枚举,直到级别 1,否则执行递归枚举,默认值 false

resume
Boolean

如果为 true,则我们想要从上次传输恢复,默认值为 false

isBinary
Boolean

如果为 false,则会在换行符边界处将文件写入数据湖,但如果文件在 4MB 区块内没有换行符,则会引发异常。 如果为 true,则不会在新行边界处上传,但上传速度更快。 默认情况下为 false,如果文件在 4MB 区块内没有换行符,则应将 true

cancelToken
CancellationToken

取消令牌

返回

封装上传详细信息的传输状态

适用于