PurgeTransactionSequenceData méthode
Vide les données spécifiées de la table d'historique des transactions.
Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (dans System.Data.SqlServerCe.dll)
Syntaxe
'Déclaration
Public Sub PurgeTransactionSequenceData ( _
pType As PurgeType, _
retentionValue As Long _
)
'Utilisation
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
)
Paramètres
- pType
Type : System.Data.SqlServerCe. . :: . .PurgeType
L'une des valeurs de PurgeType qui spécifie si le vidage est basé sur la date ou sur le numéro séquentiel de validation de la dernière transaction pour modifier les données de l'historique des transactions.
- retentionValue
Type : System. . :: . .Int64
Nombre qui spécifie la limite jusqu'à laquelle les lignes doivent être conservées. Dans le cas d'un vidage basé sur la date, le paramètre spécifie le nombre de jours à partir de la date du jour pour lesquels conserver les données de l'historique des transactions. Dans le cas d'un vidage basé sur le numéro séquentiel de validation, ce paramètre spécifie le numéro séquentiel de validation de la dernière transaction pour laquelle les données de l'historique des transactions doivent être conservées.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | retentionValue est inférieur à zéro. -ou- purgeType n'est pas une valeur PurgeType valide. |
Notes
À mesure que les transactions sont validées, une entrée est ajoutée à la table d'historique des transactions (__sysTxCommitSequence) qui contient les informations de suivi relatives à la transaction. Vous pouvez limiter la taille de cette table en supprimant des lignes pour les transactions qui ne sont plus pertinentes pour votre application.
Vous pouvez spécifier l'un des deux types de vidage suivants à l'aide du paramètre pType :
Vidage basé sur la date. Dans le cas d'un vidage basé sur la date, le paramètre retentionValue spécifie le nombre de jours, à compter de la date du jour, pendant lesquels les lignes sont conservées dans la table d'historique des transactions. Toute ligne modifiée à la date de rétention ou après celle-ci est conservée ; toute ligne modifiée avant la date de rétention est supprimée.
Vidage basé sur le numéro séquentiel de validation. Ce type de vidage est également appelé vidage basé sur les transactions. Dans le cas d'un vidage basé sur le numéro séquentiel de validation, le paramètre retentionValue spécifie le numéro séquentiel de validation de la dernière transaction pour laquelle des lignes doivent être conservées dans la table d'historique des transactions. Les lignes dont la dernière modification a été effectuée par une transaction avec un numéro séquentiel de validation supérieur ou égal au numéro séquentiel de validation spécifié sont conservées ; celles dont la dernière modification a été effectuée par une transaction avec un numéro séquentiel de validation inférieur au numéro séquentiel de validation spécifié sont supprimées. Vous pouvez obtenir le numéro séquentiel de validation actuel d'une source de données (le numéro séquentiel de validation attribué à la dernière transaction à valider) en appelant la méthode GetLastCommittedCsn.
Notes
Le numéro séquentiel de validation est un compteur à incrémentation fixe attribué par la base de données à chaque transaction (dans laquelle la base de données est inscrite) lorsqu'elle est validée. Le numéro séquentiel de validation identifie de façon unique la séquence dans laquelle chaque transaction a été validée par rapport aux autres transactions validées dans lesquelles la base de données a également été inscrite.
Pour plus d'informations sur les différences entre un vidage basé sur la date et un vidage basé sur le numéro séquentiel de validation, consultez la rubrique consacrée à l'énumération de PurgeType.