DataLakeFileClient.Append メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この操作により Append(Stream, Int64, DataLakeFileAppendOptions, CancellationToken) 、ファイルに追加されるデータがアップロードされます。 データはファイルにのみ追加できます。 以前にアップロードしたデータをファイルに適用するには、Flush Data を呼び出します。 現在、Append は要求あたり 4000 MB に制限されています。 大きなファイルを一度にアップロードするには、 の使用を Upload(Stream)検討してください。
詳細については、「 パスを更新します。
public virtual Azure.Response Append (System.IO.Stream content, long offset, Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions options = default, System.Threading.CancellationToken cancellationToken = default);abstract member Append : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> Azure.Response
override this.Append : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> Azure.ResponsePublic Overridable Function Append (content As Stream, offset As Long, Optional options As DataLakeFileAppendOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Responseパラメーター
- offset
- Int64
このパラメーターを使用すると、呼び出し元はデータを並行してアップロードし、ファイルに追加する順序を制御できます。 ファイルに追加するデータをアップロードするとき、および以前にアップロードしたデータをファイルにフラッシュするときに必要です。 値は、データを追加する位置である必要があります。 アップロードされたデータは、ファイルにすぐにフラッシュされたり、書き込まれたりしません。 フラッシュするには、以前にアップロードしたデータが連続している必要があります。position パラメーターは、すべてのデータが書き込まれた後のファイルの長さと同じで、要求に含まれる要求エンティティ本文が存在しないようにする必要があります。
- options
- DataLakeFileAppendOptions
省略可能なパラメーター。
- cancellationToken
- CancellationToken
操作を取り消す必要があることを示す通知を伝達する場合は省略可能 CancellationToken です。
戻り値
Response更新されたファイルの状態を記述する 。
注釈
RequestFailedExceptionエラーが発生すると、 がスローされます。
適用対象
Azure SDK for .NET