使用保留策略管理历史数据

定义数据库和基础表的数据保留策略后，将运行后台计时器任务，以从启用了数据保留的表中删除任何已过时的记录。 识别匹配行并将其从表中删除，这些操作以透明方式在系统计划和运行的后台任务中进行。 根据表定义中指定的 filter_column 列检查表行的期限条件。 例如，如果保留期设置为一周，则应清理的表行应符合以下条件之一：

• 如果筛选器列使用 DATETIMEOFFSET 数据类型，那么条件为 filter_column < DATEADD(WEEK, -1, SYSUTCDATETIME())
• 否则，条件为 filter_column < DATEADD(WEEK, -1, SYSDATETIME())

数据保留清理阶段

数据保留清理操作包括两个阶段：

1. 发现：在此阶段中，清理操作将标识用户数据库中的所有表，以生成清理列表。 发现一天运行一次。
2. 清理：在此阶段中，对发现阶段标识的具有有限数据保留期的所有表运行清理。 如果无法对表执行清理操作，则会在当前运行中跳过该表，并将在下一次迭代中重试。 清理过程中使用以下原则：
   • 如果已过时的行被另一个事务锁定，则会跳过该行。
   • 清理会运行，默认锁定超时设置为 5 秒。 如果无法在超时时限内获取表上的锁定，则会在当前运行中跳过该表，并将在下一次迭代中重试。
   • 如果在清理表的过程中发生错误，则会跳过该表，并将在下一次迭代中选取该表。

手动清理

自动清理线程可能无法在其运行期间完全删除所有已过时的行，具体取决于表上的数据保留设置以及数据库上工作负载的性质。 为了允许用户手动删除过时的行，Azure SQL Edge 中引入了 sys.sp_cleanup_data_retention 存储过程。

此存储过程采用三个参数：

• @schema_name：表自身的架构的名称。 必需。
• @table_name：正在为其运行手动清理的表的名称。 必需。
• @rowcount：输出变量 返回由手动清理 sp 清理的行数。 可选。

有关详细信息，请参阅 sys.sp_cleanup_data_retention (Transact-SQL)。

以下示例演示了如何为表 dbo.data_retention_table 执行手动清理 sp。

DECLARE @rowcnt BIGINT;
EXEC sys.sp_cleanup_data_retention 'dbo', 'data_retention_table', @rowcnt OUTPUT;
SELECT @rowcnt;

如何删除已过时的行

清理过程取决于表的索引布局。 对于具有有限保留期的所有表，系统会创建一个后台任务来执行已过时数据的清理。 行存储（堆或 B 树）索引的清理逻辑以较小的区块（最大 10,000）删除陈旧行，从而可以最大程度地减轻数据库日志和 IO 子系统的压力。 尽管清理逻辑利用所需的 B 树索引，但不一定能够保证按顺序删除超过保留期的行。 换言之，不要对应用程序中的清理顺序有任何依赖。

聚集列存储的索引清理任务可同时移除整个行组（每组通常包含 100 万行），效率非常高，在数据高速生成和老化时尤其如此。

聚集列存储索引具有优秀的数据压缩和高效的保留清理能力，是工作负载快速生成大量数据时的最佳选择。

监视数据保留清理

可以使用 Azure SQL Edge 中的扩展事件监视数据保留策略清理操作。 有关扩展事件的详细信息，请参阅扩展事件概述。

以下扩展事件有助于跟踪清理操作的状态。

名称	说明
data_retention_task_started	在使用保留策略清理表的后台任务开始时发生。
data_retention_task_completed	在使用保留策略清理表的后台任务结束时发生。
data_retention_task_exception	在特定于这些表的保留清理过程外，使用保留策略清理表的后台任务失败时发生。
data_retention_cleanup_started	在使用数据保留策略的表的清理过程开始时发生。
data_retention_cleanup_exception	在使用保留策略的表的清理过程失败时发生。
data_retention_cleanup_completed	在使用数据保留策略的表的清理过程结束时发生。

此外，sys.dm_os_ring_buffers 动态管理视图中添加了名为 RING_BUFFER_DATA_RETENTION_CLEANUP 的新环形缓冲区类型。 此视图可用于监视数据保留清理操作。

后续步骤

• 数据保留策略
• 启用和禁用数据保留策略