PurgeTombstoneTableData méthode
Vide les données tombstone pour la table spécifiée.
Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (dans System.Data.SqlServerCe.dll)
Syntaxe
'Déclaration
Public Sub PurgeTombstoneTableData ( _
tableName As String, _
pType As PurgeType, _
retentionValue As Long _
)
'Utilisation
Dim instance As SqlCeChangeTracking
Dim tableName As String
Dim pType As PurgeType
Dim retentionValue As Long
instance.PurgeTombstoneTableData(tableName, _
pType, retentionValue)
public void PurgeTombstoneTableData(
string tableName,
PurgeType pType,
long retentionValue
)
public:
void PurgeTombstoneTableData(
String^ tableName,
PurgeType pType,
long long retentionValue
)
member PurgeTombstoneTableData :
tableName:string *
pType:PurgeType *
retentionValue:int64 -> unit
public function PurgeTombstoneTableData(
tableName : String,
pType : PurgeType,
retentionValue : long
)
Paramètres
- tableName
Type : System. . :: . .String
Nom de la table pour laquelle les données tombstone doivent être supprimées.
- 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 tombstone.
- retentionValue
Type : System. . :: . .Int64
Nombre qui spécifie la limite jusqu'à laquelle les lignes tombstone doivent être conservées. Dans le cas d'un vidage basé sur la date, ce paramètre spécifie le nombre de jours, à partir de la date du jour, pendant lesquels les données tombstone doivent être conservées. 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 tombstone doivent être conservées.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | retentionValue est inférieur à zéro. -ou- purgeType n'est pas une valeur PurgeType valide. |
Notes
La méthode PurgeTombstoneTableData supprime (vide) des lignes de la table tombstone (__sysOCSDeletedRows). Lorsque des lignes sont supprimées d'une table faisant l'objet d'un suivi, l'infrastructure de suivi déplace les lignes supprimées vers la table tombstone. Avec le temps, cette table peut devenir très volumineuse dans la mesure où l'infrastructure de suivi utilise la table tombstone pour conserver les lignes supprimées pour toutes les tables faisant l'objet d'un suivi dans le système. Vous pouvez utiliser la méthode PurgeTombstoneTableData pour limiter la taille de la table tombstone en vidant régulièrement des lignes de celle-ci.
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 tombstone. Toutes les lignes de la table spécifiée supprimées à la date de rétention ou après celle-ci sont conservées dans la table tombstone ; toutes les lignes supprimées avant la date de rétention sont supprimées de la table tombstone.
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 tombstone. Toutes les lignes supprimées de la table spécifiée à l'aide d'une transaction dont le numéro séquentiel de validation est supérieur ou égal au numéro séquentiel de validation spécifié sont conservées dans la table tombstone ; les lignes supprimées à l'aide d'une transaction dont le numéro séquentiel de validation est inférieur au numéro séquentiel de validation spécifié sont supprimés de la table tombstone. 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.