Merge pull request #36546 from dimitri-furman/dfurman/adr

Clarify PVS cleanup details

Author: prmerger-automator[bot]

docs/relational-databases/system-dynamic-management-views/sys-dm-tran-persistent-version-store-stats.md

@@ -4,7 +4,7 @@ description: sys.dm_tran_persistent_version_store_stats returns information for
 author: rwestMSFT
 ms.author: randolphwest
 ms.reviewer: wiassaf, dfurman
-ms.date: 02/05/2025
+ms.date: 02/02/2026
 ms.service: sql
 ms.subservice: system-objects
 ms.topic: "reference"
@@ -42,10 +42,10 @@ Returns information for accelerated database recovery (ADR) persistent version s
 | `min_transaction_timestamp` | **bigint** | The minimum useful timestamp in the system from snapshot scans. |
 | `online_index_min_transaction_timestamp` | **bigint** | The minimum useful timestamp in the system to hold up the PVS cleanup during online index builds. |
 | `secondary_low_water_mark` | **bigint** | The low water mark aggregated for queries on readable secondaries. The value is a transaction ID and can be matched with `oldest_active_transaction_id` and `oldest_aborted_transaction_id`. |
-| `offrow_version_cleaner_start_time` | **datetime2(7)** | The last start time of the off-row PVS cleanup process. |
-| `offrow_version_cleaner_end_time` | **datetime2(7)** | The last end time of the off-row PVS cleanup process. If start time has value but the end time doesn't, it means PVS cleanup is ongoing on this database. |
-| `aborted_version_cleaner_start_time` | **datetime2(7)** | The start timestamp of the last aborted transaction sweep. |
-| `aborted_version_cleaner_end_time` | **datetime2(7)** | The end timestamp of last aborted transaction sweep. If start time has value but the end time doesn't, it means PVS cleanup is ongoing on this database. |
+| `offrow_version_cleaner_start_time` | **datetime2(7)** | The start time of the last sweep that cleaned up off-row versions. |
+| `offrow_version_cleaner_end_time` | **datetime2(7)** | The end time of the last sweep that cleaned up off-row versions. If start time has value but the end time doesn't, it means PVS cleanup is ongoing on this database. |
+| `aborted_version_cleaner_start_time` | **datetime2(7)** | The start timestamp of the last sweep that cleaned up aborted transactions. |
+| `aborted_version_cleaner_end_time` | **datetime2(7)** | The end timestamp of last sweep that cleaned up aborted transactions. If start time has value but the end time doesn't, it means PVS cleanup is ongoing on this database. |
 | `pvs_off_row_page_skipped_low_water_mark` | **bigint** | The number of pages skipped during cleanup due to hold up from secondary read queries. |
 | `pvs_off_row_page_skipped_transaction_not_cleaned` | **bigint** | The number of pages skipped during cleanup due to aborted transactions. Note this value doesn't reflect the PVS hold up from aborted transactions since the version cleaner uses a min threshold for aborted transaction version cleanup. Can be ignored when troubleshooting large PVS issues. |
 | `pvs_off_row_page_skipped_oldest_active_xdesid` | **bigint** | The number of pages skipped during cleanup due to the oldest active transaction. |

docs/relational-databases/system-stored-procedures/sys-sp-persistent-version-cleanup-transact-sql.md

@@ -4,7 +4,7 @@ description: "Manually starts persistent version store (PVS) cleanup process, a
 author: rwestMSFT
 ms.author: randolphwest
 ms.reviewer: dfurman
-ms.date: 10/19/2025
+ms.date: 02/02/2026
 ms.service: sql
 ms.subservice: system-objects
 ms.topic: "reference"
@@ -23,7 +23,7 @@ monikerRange: ">=sql-server-ver15 || >=sql-server-linux-ver15 || =azuresqldb-mi-
 
 [!INCLUDE [SQL Server 2019, ASDB, ASDBMI-fabricsqldb](../../includes/applies-to-version/sqlserver2019-asdb-asdbmi-fabricsqldb.md)]
 
-Manually starts persistent version store (PVS) cleanup process, a key element of accelerated database recovery (ADR). This cleaner also removes uncommitted data in PVS from aborted transactions.
+Manually starts persistent version store (PVS) cleanup process, a key element of accelerated database recovery (ADR). The cleaner removes obsolete row versions from the in-row and off-row [PVS storage](../sql-server-transaction-locking-and-row-versioning-guide.md#space-used-by-the-persistent-version-store-pvs), and also removes uncommitted changes in PVS from aborted transactions.
 
 It isn't typically necessary to start the PVS cleanup process manually using `sys.sp_persistent_version_cleanup`. However in some scenarios, you might want to initiate the PVS cleanup process manually during a known period of rest/recovery after busy OLTP activity.
 
@@ -53,15 +53,15 @@ Optional. *@scanallpages* is **bit**, with a default of `0`. When set to `1`, th
 
 #### [ @clean_option = ] *clean_option*
 
-Optional. Possible options determine whether or not to reclaim off-row PVS page. *@clean_option* is **int**, with a default of `0`. This reference isn't commonly needed and the default value `0` is recommended.
+Optional. The option to determine the type of cleanup to perform. *@clean_option* is **int**, with a default of `0`. This parameter isn't commonly needed and the default value `0` is recommended.
 
 | Value | Description |
-| :--- | :--- |
-| `0` | Default, no option specified |
-| `1` | off-row version store without checking individual PVS page contents |
-| `2` | off-row version store with each PVS page visited |
-| `3` | in-row version store only |
-| `4` | internal use only |
+| --- | --- |
+| `0` | Default, perform all cleanup. |
+| `1` | Clean up the off-row [version storage](../sql-server-transaction-locking-and-row-versioning-guide.md#space-used-by-the-persistent-version-store-pvs) without examining PVS page contents. Faster, but might skip deallocation of unused pages in PVS. This is the default behavior when `@clean_option` is omitted or set to `0`. |
+| `2` | Clean up the off-row [version storage](../sql-server-transaction-locking-and-row-versioning-guide.md#space-used-by-the-persistent-version-store-pvs) by checking each PVS page contents. Slower, but always deallocates all unused pages. |
+| `3` | Clean up the in-row [version storage](../sql-server-transaction-locking-and-row-versioning-guide.md#space-used-by-the-persistent-version-store-pvs) only. |
+| `4` | Clean up row versions generated by aborted transactions only (also known as logical revert). |
 
 ## Return code values