DataLakeFileClient.AppendAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この操作により 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)
パラメーター
- offset
- Int64
このパラメーターを使用すると、呼び出し元はデータを並行してアップロードし、ファイルに追加する順序を制御できます。 ファイルに追加するデータをアップロードするとき、および以前にアップロードしたデータをファイルにフラッシュするときに必要です。 値は、データを追加する位置である必要があります。 アップロードされたデータは、ファイルにすぐにフラッシュまたは書き込まれるわけではありません。 フラッシュするには、以前にアップロードしたデータが連続している必要があります。position パラメーターを指定し、すべてのデータが書き込まれた後のファイルの長さと同じにする必要があり、要求に含まれる要求エンティティ本文が存在しないようにする必要があります。
- options
- DataLakeFileAppendOptions
省略可能なパラメーター。
- cancellationToken
- CancellationToken
操作を取り消す必要がある通知を伝達する場合は省略可能 CancellationToken です。
戻り値
Response更新されたファイルの状態を記述する 。
注釈
RequestFailedExceptionエラーが発生すると、 がスローされます。
適用対象
Azure SDK for .NET