トランザクションセレクター

以下のリストでは、Retention アプリケーションで保持ポリシーを設定するときに利用可能なトランザクションセレクターについて説明します。

this format の形式のテキストは、各ポリシーで定義できるパラメーターを表します。

ブランチ内のみ

指定されたブランチにのみ存在するトランザクションを削除します。

引数1個： branch

例：「ブランチ main 内のみ」

「ブランチ main 内のみ」を設定しても、最初の2個の SNAPSHOT トランザクションは削除されません。これらは、フィーチャーブランチの SNAPSHOT トランザクションのルートトランザクションでもあるためです。

ブランチ内にない

指定されたブランチ内のトランザクションを除く、すべてのトランザクションを削除します。

引数1個： branch

例：「ブランチ main 内にない」

トランザクション件数

各ブランチで、データを含む最新の number of transaction to retain 個のトランザクションのみを保持します。次の条件がすべて true の場合にのみ、トランザクションはデータを含むものと定義されます。

• トランザクションがコミットされている。
• トランザクションが DELETE トランザクションではない。

中止されたトランザクションはいずれもデータを含まないため、削除されます。このセレクターは SNAPSHOT、APPEND、UPDATE トランザクションを区別しないため、インクリメンタル（差分処理）パイプラインでは viewCount セレクターの使用を推奨します。

引数1個： number of transactions to retain

例：「トランザクション件数 2」

このセレクターにより、各ブランチで少なくとも 2 個の SNAPSHOT トランザクションが利用可能になります。フィーチャーブランチには3個のトランザクションが残る場合があります。最も古いトランザクションはブランチ main の2番目のトランザクションでもあるため、削除されません。

ビュー数

ビュー数セレクターは、最新の number of views to retain 個のデータセットビュー内のトランザクションのみを保持します。ビューはコミットされたトランザクションのみで構成されると定義されているため、中止されたトランザクションもすべて削除されます。たとえば、numViewsToRetain: 1 は、最新のビューより前のすべてのトランザクション（つまり、最新の SNAPSHOT トランザクションより前のすべてのトランザクション）と、中止されたすべてのトランザクションが削除されることを意味します。

引数1個： number of views to retain

例：「ビュー数 1」

一定期間より古い

指定された期間より古いトランザクションを選択します。

引数1個： duration

プロジェクションに反映済み（高度な機能）

プロジェクションを持つデータセットでは、このセレクターはすべてのプロジェクションに伝播されたトランザクションを選択します。

アクティブビューにファイルがありません（高度な機能）

このセレクターは、最新のビューに含まれていないすべてのトランザクションを選択します。また、最新のビュー内のトランザクションのうち、そのファイルがすべて新しいトランザクションのファイルで置き換えられたものも選択します。最新のビューからの削除を許可 と併用すると、そのビューにまだ含まれている置き換え済みのトランザクションを保持ポリシーで削除できるようになります。

隠しファイルを無視する

隠しファイルとは、データセットのデータを含まないファイルです。名前が . で始まるファイル、または _driver.log のように _ で始まり = を含まないファイルは、隠しファイルとみなされます。隠しファイルを無視するが無効の場合、アクティブビューにファイルがありませんは、トランザクションのファイルがアクティブビューにまだ存在するかどうかを判断する際に、これらのファイルも考慮します。

隠しファイルを無視するは、アクティブビューにファイルがありませんセレクターのオプションです。有効にすると、セレクターの評価時にデータファイルのみが考慮されます。その結果、隠しファイルがまだ存在していても、データファイルがアクティブビューに1つも残っていないトランザクションを選択できるようになります。

指定期間より古いビューにのみ存在（高度な機能）

指定された期間より古いビューにのみ存在するトランザクションを選択します。ビューの経過時間は、そのビュー内の最新のトランザクションのクローズ時刻から現在までの時間と定義されます。ビューにオープンなトランザクションがある場合、そのビュー内のトランザクションはいずれも削除されません。

引数1個： duration

派生トランザクション（高度な機能）

派生トランザクションを選択します。これは、ビルドの実行によって生成されたトランザクションです。データの手動アップロードや Data Connection を通じて作成されたトランザクションは、派生トランザクションとはみなされません。