AdlsClient.BulkUpload メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
BulkUpload(String, String, Int32, IfExists, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken) |
ローカルからリモートにディレクトリまたはファイルをアップロードします。 転送先ディレクトリのソース ディレクトリの下にコンテンツを転送します。 ソース ファイルを転送し、宛先パスとして保存します。
このメソッドは、エントリの転送エラーに対して例外をスローしません。 戻り値 TransferStatus を参照して、各エントリの転送の状態/例外を取得します。
AdlsClient のインスタンスを作成する前に、ServicePointManager.DefaultConnectionLimit を sdk で使用するスレッド数に設定することを強くお勧めします。
既定では、ServicePointManager.DefaultConnectionLimit は 2 に設定されています。
既定では、ファイルは新しい行境界でアップロードされます。 ただし、ファイルに 4 MB のチャンク内に改行がない場合、転送は失敗します。 その場合は、改行境界でのアップロードを回避するために true を |
BulkUpload(String, String, Int32, IfExists, Boolean, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken) |
ローカルからリモートにディレクトリまたはファイルをアップロードします。 転送先ディレクトリのソース ディレクトリの下にコンテンツを転送します。 ソース ファイルを転送し、宛先パスとして保存します。
このメソッドは、エントリの転送エラーに対して例外をスローしません。 戻り値 TransferStatus を参照して、各エントリの転送の状態/例外を取得します。
既定では、転送の進行状況がシステムの一時パスに記録されるため、アップロードがクラッシュした場合に ユーザーが を使用して |
BulkUpload(String, String, Int32, IfExists, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken)
ローカルからリモートにディレクトリまたはファイルをアップロードします。 転送先ディレクトリのソース ディレクトリの下にコンテンツを転送します。 ソース ファイルを転送し、宛先パスとして保存します。
このメソッドは、エントリの転送エラーに対して例外をスローしません。 戻り値 TransferStatus を参照して、各エントリの転送の状態/例外を取得します。
AdlsClient のインスタンスを作成する前に、ServicePointManager.DefaultConnectionLimit を sdk で使用するスレッド数に設定することを強くお勧めします。
既定では、ServicePointManager.DefaultConnectionLimit は 2 に設定されています。
既定では、ファイルは新しい行境界でアップロードされます。 ただし、ファイルに 4 MB のチャンク内に改行がない場合、転送は失敗します。 その場合は、改行境界でのアップロードを回避するために 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>
ファイル転送の進行状況を追跡する Progresstracker
- notRecurse
- Boolean
true の場合は、レベル 1 まで列挙を行い、それ以外の場合は再帰的列挙を行います
- resume
- Boolean
true の場合は、最後の転送から再開します
- isBinary
- Boolean
false の場合、改行境界でデータ レイクにファイルが書き込まれますが、ファイルに 4 MB チャンク内に改行がない場合は例外がスローされます。 true の場合、新しい行境界でのアップロードは保証されませんが、アップロードは高速になります。 既定では false、ファイルに 4 MB チャンク内に改行がない場合は true を apssed にする必要があります
- cancelToken
- CancellationToken
キャンセル トークン
戻り値
アップロードの詳細をカプセル化する転送状態
適用対象
BulkUpload(String, String, Int32, IfExists, Boolean, IProgress<TransferStatus>, Boolean, Boolean, Boolean, CancellationToken)
ローカルからリモートにディレクトリまたはファイルをアップロードします。 転送先ディレクトリのソース ディレクトリの下にコンテンツを転送します。 ソース ファイルを転送し、宛先パスとして保存します。
このメソッドは、エントリの転送エラーに対して例外をスローしません。 戻り値 TransferStatus を参照して、各エントリの転送の状態/例外を取得します。
既定では、転送の進行状況がシステムの一時パスに記録されるため、アップロードがクラッシュした場合に ユーザーが を使用して resume
復旧できます。
この進行状況ログは、 を使用して disableTransferLogging
無効にすることができます。
AdlsClient のインスタンスを作成する前に、ServicePointManager.DefaultConnectionLimit を sdk で使用するスレッド数に設定することを強くお勧めします。
既定では、ServicePointManager.DefaultConnectionLimit は 2 に設定されています。
既定では、ファイルは新しい行境界でアップロードされます。 ただし、ファイルに 4 MB のチャンク内に改行がない場合、転送は失敗します。 その場合は、改行境界でのアップロードを回避するために 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>
ファイル転送の進行状況を追跡する Progresstracker、既定の null
- notRecurse
- Boolean
true の場合は、レベル 1 まで列挙を行い、それ以外の場合は再帰的列挙を行います。既定値は false です。
- resume
- Boolean
true の場合、最後の転送から再開する場合は、既定の false
- isBinary
- Boolean
false の場合、改行境界でデータ レイクにファイルが書き込まれますが、ファイルに 4 MB チャンク内に改行がない場合は例外がスローされます。 true の場合、新しい行境界でのアップロードは保証されませんが、アップロードは高速になります。 既定では false、ファイルに 4 MB チャンク内に改行がない場合は true を apssed にする必要があります
- cancelToken
- CancellationToken
キャンセル トークン
戻り値
アップロードの詳細をカプセル化する転送状態
適用対象
Azure SDK for .NET