TaskOutputStorage.SaveTrackedAsync メソッド

定義

名前空間:

Microsoft.Azure.Batch.Conventions.Files

アセンブリ:

Microsoft.Azure.Batch.Conventions.Files.dll

パッケージ:

Microsoft.Azure.Batch.Conventions.Files v4.0.0

オーバーロード

SaveTrackedAsync(String)	指定したファイルを 永続ストレージに として TaskLog保存し、後続の追加をファイルに追跡し、永続コピーにも追加します。
SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)	指定したファイルを永続ストレージに保存し、後続の追加をファイルに追跡し、永続コピーにも追加します。

SaveTrackedAsync(String)

ソース:

TaskOutputStorage.cs

指定したファイルを 永続ストレージに として TaskLog保存し、後続の追加をファイルに追跡し、永続コピーにも追加します。

public System.Threading.Tasks.Task<Microsoft.Azure.Batch.Conventions.Files.ITrackedSaveOperation> SaveTrackedAsync (string relativePath);

member this.SaveTrackedAsync : string -> System.Threading.Tasks.Task<Microsoft.Azure.Batch.Conventions.Files.ITrackedSaveOperation>

Public Function SaveTrackedAsync (relativePath As String) As Task(Of ITrackedSaveOperation)

パラメーター

relativePath

String

現在のディレクトリを基準にして保存するファイルのパス。 ファイルが現在のディレクトリのサブディレクトリにある場合、相対パスは BLOB ストレージに保持されます。

戻り値

Task<ITrackedSaveOperation>

ITrackedSaveOperationファイルを BLOB ストレージに保存し、破棄されるまで定期的に BLOB にファイルの追加をフラッシュします。 破棄されると、残りのすべての追加が BLOB ストレージにフラッシュされ、ファイルの追加の追跡がさらに停止されます。

例外

ArgumentNullException

relativePath 引数が null です。

ArgumentException

引数が relativePath 絶対パスであるか、空です。

注釈

追跡では、追加のみがサポートされます。 つまり、ファイルの追跡中は、末尾に追加されたデータが永続ストレージに追加されます。 既にアップロードされているデータに対する変更は、永続ストアには反映されません。 したがって、このメソッドは、データがファイルの末尾にのみ追加される (ローテーションされていない) ログ ファイルなどのファイルでのみ使用することを目的としています。 ファイルの内容全体が変更される可能性がある場合は、 を使用 SaveAsync(TaskOutputKind, String, CancellationToken) して、定期的に、または変更後に呼び出します。

ファイルが現在のディレクトリの外部にある場合、ディレクトリ ツリー上の走査は削除されます。 たとえば、 relativePath の です。\ProcessEnv.cmd" は、BLOB 名を作成するために "ProcessEnv.cmd" として扱われます。

SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)

ソース:

TaskOutputStorage.cs

指定したファイルを永続ストレージに保存し、後続の追加をファイルに追跡し、永続コピーにも追加します。

public System.Threading.Tasks.Task<Microsoft.Azure.Batch.Conventions.Files.ITrackedSaveOperation> SaveTrackedAsync (Microsoft.Azure.Batch.Conventions.Files.TaskOutputKind kind, string sourcePath, string destinationRelativePath, TimeSpan flushInterval);

member this.SaveTrackedAsync : Microsoft.Azure.Batch.Conventions.Files.TaskOutputKind * string * string * TimeSpan -> System.Threading.Tasks.Task<Microsoft.Azure.Batch.Conventions.Files.ITrackedSaveOperation>

Public Function SaveTrackedAsync (kind As TaskOutputKind, sourcePath As String, destinationRelativePath As String, flushInterval As TimeSpan) As Task(Of ITrackedSaveOperation)

パラメーター

kind

TaskOutputKind

TaskOutputKindこのファイルTaskOutputTaskLogを格納するカテゴリを表す 。

sourcePath

String

保存するファイルのパス。

destinationRelativePath

String

ファイルを保存する BLOB 名。 これには、"pointclouds/pointcloud_0001.txt" などの相対コンポーネントが含まれる場合があります。

flushInterval

TimeSpan

永続ストレージに追加をフラッシュする間隔。

戻り値

Task<ITrackedSaveOperation>

ITrackedSaveOperationファイルを BLOB ストレージに保存し、破棄されるまで定期的に BLOB にファイルの追加をフラッシュします。 破棄されると、残りのすべての追加が BLOB ストレージにフラッシュされ、ファイルの追加の追跡がさらに停止されます。

例外

ArgumentNullException

、kindsourcePath、または destinationRelativePath 引数が null です。

ArgumentException

sourcePathまたは destinationRelativePath 引数が空です。

注釈

追跡では、追加のみがサポートされます。 つまり、ファイルの追跡中は、末尾に追加されたデータが永続ストレージに追加されます。 既にアップロードされているデータに対する変更は、永続ストアには反映されません。 したがって、このメソッドは、データがファイルの末尾にのみ追加される (ローテーションされていない) ログ ファイルなどのファイルでのみ使用することを目的としています。 ファイルの内容全体が変更される可能性がある場合は、 を使用 SaveAsync(TaskOutputKind, String, String, CancellationToken) して、定期的に、または変更後に呼び出します。