sys.sp_propreup_temporal_history (Transact-SQL)

  • Article

S’applique à : Azure SQL DatabaseAzure SQL Managed Instance

Supprime toutes les lignes de la table d’historique temporelle qui correspondent à la configuration HISTORY_RETENTION PERIOD dans une seule transaction.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_cleanup_temporal_history
    [ @schema_name = ] N'schema_name'
    , [ @table_name = ] N'table_name'
    [ , [ @row_count = ] @row_count_var [ OUTPUT ] ]

Arguments

[ @schema_name = ] N’schema_name'

Nom de la table temporelle pour laquelle la rétention propre up est appelée.

[ @table_name = ] N’table_name'

Nom du schéma auquel appartient la table temporelle actuelle.

[ @row_count = ] @row_count_var [ OUTPUT ]

Paramètre de sortie qui retourne le nombre de lignes supprimées. Si la table d’historique a un index columnstore cluster, ce paramètre retourne 0.

Notes

Cette procédure stockée peut être utilisée uniquement avec les tables temporelles qui ont une période de rétention limitée spécifiée. Utilisez cette procédure stockée uniquement si vous devez immédiatement propre toutes les lignes anciennes de la table d’historique.

sp_cleanup_temporal_history peut avoir un impact négatif sur le journal de base de données et le sous-système d’E/S, car il supprime toutes les lignes éligibles dans la même transaction.

Il est toujours recommandé de s’appuyer sur une tâche en arrière-plan interne pour propre up qui supprime les lignes anciennes avec un impact minimal sur les charges de travail et la base de données régulières en général.

Autorisations

Nécessite des autorisations db_owner .

Exemples

DECLARE @rowcnt INT;

EXEC sys.sp_cleanup_temporal_history 'dbo', 'Department', @rowcnt OUTPUT;

SELECT @rowcnt;

Contenu connexe