PurgeTransactionSequenceData メソッド
指定したデータをトランザクション履歴テーブルから削除します。
名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (System.Data.SqlServerCe.dll)
構文
'宣言
Public Sub PurgeTransactionSequenceData ( _
pType As PurgeType, _
retentionValue As Long _
)
'使用
Dim instance As SqlCeChangeTracking
Dim pType As PurgeType
Dim retentionValue As Long
instance.PurgeTransactionSequenceData(pType, _
retentionValue)
public void PurgeTransactionSequenceData(
PurgeType pType,
long retentionValue
)
public:
void PurgeTransactionSequenceData(
PurgeType pType,
long long retentionValue
)
member PurgeTransactionSequenceData :
pType:PurgeType *
retentionValue:int64 -> unit
public function PurgeTransactionSequenceData(
pType : PurgeType,
retentionValue : long
)
パラメーター
- pType
型: System.Data.SqlServerCe. . :: . .PurgeType
パージが時間に基づくか、トランザクション履歴データを変更するための最後のトランザクションのコミット シーケンス番号 (CSN) に基づくかを指定する PurgeType の値のいずれかです。
- retentionValue
型: System. . :: . .Int64
保持する行の最大数を指定する数値。時間に基づくパージの場合、パラメーターはトランザクション履歴データを保持する現在の日付からの日数を指定します。CSN に基づくパージの場合、パラメーターはトランザクション履歴データを保持する最後のトランザクションの CSN を指定します。
例外
| 例外 | 条件 |
|---|---|
| ArgumentOutOfRangeException | retentionValue に 0 より小さい値が指定されています。 または purgeType は有効な PurgeType の値ではありません。 |
説明
トランザクションのコミット時に、このトランザクションに関連する追跡情報を含むエントリが、トランザクション履歴テーブル (__sysTxCommitSequence) に作成されます。このテーブルの大きさは、アプリケーションに関係ないトランザクションの行を削除することによって制限できます。
pType パラメーターを使用すると、2 種類のパージからいずれかを指定できます。
時間に基づくパージ。時間に基づくパージの場合、retentionValue パラメーターはトランザクション履歴テーブルに行を保持する現在の日付からの日数を指定します。保持日付以降に変更された行は保持されます。保持日付より前に変更された行は削除されます。
CSN に基づくパージ。この種類のパージは、トランザクション ベースのパージとしても知られています。CSN に基づくパージの場合、retentionValue パラメーターはトランザクション履歴テーブルに行を保持する最後のトランザクションのトランザクション コミット シーケンス番号 (CSN) を指定します。指定した CSN 以上の CSN を持つトランザクションによって最後に変更された行は、保持されます。指定した CSN より小さい CSN を持つトランザクションによって最後に変更された行は、削除されます。データ ソースの現在の CSN (コミットする最後のトランザクションに割り当てられる CSN) は、GetLastCommittedCsn メソッドを呼び出すことによって取得できます。
注意
CSN は、コミット時にデータベースによって各トランザクション (データベースが参加している) に割り当てられる単純増加カウンターです。CSN は、データベースが参加してコミットされている他のトランザクションに関連して、各トランザクションがコミットされたシーケンスを一意に識別します。
時間に基づくパージと CSN に基づくパージを実行するうえでの違いについては、「PurgeType」を参照してください。