TaskOutputStorage.SaveTrackedAsync メソッド

定義

オーバーロード

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 ストレージに保持されます。

戻り値

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

例外

relativePath 引数が null です。

引数が 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

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

戻り値

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

例外

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

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

注釈

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

適用対象