DataLakeFileClient.AppendAsync メソッド

定義

この操作により AppendAsync(Stream, Int64, DataLakeFileAppendOptions, CancellationToken) 、ファイルに追加されるデータがアップロードされます。 データはファイルにのみ追加できます。 頻繁にアップロードされたデータをファイルに適用するには、Flush Data を呼び出します。 現在、追加は要求あたり 4,000 MB に制限されています。 大きなファイルをすべて一度にアップロードするには、 の使用を UploadAsync(Stream)検討してください。

詳細については、「 パスの更新

public virtual System.Threading.Tasks.Task<Azure.Response> AppendAsync (System.IO.Stream content, long offset, Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member AppendAsync : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.AppendAsync : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
Public Overridable Function AppendAsync (content As Stream, offset As Long, Optional options As DataLakeFileAppendOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

パラメーター

content
Stream

Streamアップロードするコンテンツを格納している 。

offset
Int64

このパラメーターを使用すると、呼び出し元はデータを並行してアップロードし、ファイルに追加する順序を制御できます。 ファイルに追加するデータをアップロードするとき、および以前にアップロードしたデータをファイルにフラッシュするときに必要です。 値は、データを追加する位置である必要があります。 アップロードされたデータは、ファイルにすぐにフラッシュまたは書き込まれるわけではありません。 フラッシュするには、以前にアップロードしたデータが連続している必要があります。position パラメーターを指定し、すべてのデータが書き込まれた後のファイルの長さと同じにする必要があり、要求に含まれる要求エンティティ本文が存在しないようにする必要があります。

options
DataLakeFileAppendOptions

省略可能なパラメーター。

cancellationToken
CancellationToken

操作を取り消す必要がある通知を伝達する場合は省略可能 CancellationToken です。

戻り値

Response更新されたファイルの状態を記述する 。

注釈

RequestFailedExceptionエラーが発生すると、 がスローされます。

適用対象