sys.dm_db_page_info (Transact-SQL)

發行項
06/19/2023

適用於：SQL Server 2019 (15.x)Azure SQL Database Azure SQL 受控執行個體

傳回資料庫中頁面的相關資訊。此函式會傳回一個包含頁面中標頭資訊的資料列，包括 object_id、index_id 和 partition_id。在大部分情況下，有此函式就不需要使用 DBCC PAGE。

注意

sys.dm_db_page_info 目前僅在 SQL Server 2019 (15.x) 和更新版本中才受支援。

語法

sys.dm_db_page_info ( DatabaseId , FileId , PageId , Mode )

引數

DatabaseId | NULL | DEFAULT

資料庫的識別碼。 DatabaseId 是 smallint。有效的輸入是資料庫的識別碼。預設值為 NULL，不過傳送此參數的 NULL 值將會導致錯誤。

FileId | NULL | DEFAULT

檔案的 ID。 FileId 是 int。有效的輸入是 DatabaseId 所指定之資料庫中檔案的識別碼。預設值為 NULL，不過傳送此參數的 NULL 值將會導致錯誤。

PageId | NULL | DEFAULT

頁面的識別碼。 PageId 是 int。有效的輸入是 FileId 所指定之檔案中頁面的識別碼。預設值為 NULL，不過傳送此參數的 NULL 值將會導致錯誤。

Mode | NULL | DEFAULT

決定函式輸出中的詳細資料層級。 'LIMITED' 會傳回所有描述資料行的 NULL 值，'DETAILED' 會填入描述資料行。 DEFAULT 為 'LIMITED'。

傳回的表格

資料行名稱	資料類型	描述
database_id	int	資料庫識別碼。在 Azure SQL 資料庫中，這些值在單一資料庫或彈性集區內是唯一的，但在邏輯伺服器內則不是唯一的。
file_id	int	檔案識別碼
page_id	int	頁面識別碼
page_header_version	int	頁面標頭版本
page_type	int	頁面類型
page_type_desc	nvarchar(64)	頁面類型的描述
page_type_flag_bits	nvarchar(64)	頁面標頭中的類型旗標位元
page_type_flag_bits_desc	nvarchar(64)	頁面標頭中的類型旗標位元描述
page_flag_bits	nvarchar(64)	頁面標頭中的旗標位元
page_flag_bits_desc	nvarchar(256)	頁面標頭中的旗標位元描述
page_lsn	nvarchar(64)	記錄序號/時間戳記
page_level	int	索引中頁面的層級 (分葉 = 0)
object_id	int	擁有頁面的物件識別碼
index_id	int	索引的識別碼 (0 代表堆積資料頁面)
partition_id	bigint	資料分割的識別碼
alloc_unit_id	bigint	配置單位的識別碼
is_encrypted	bit	指出頁面是否已加密的位元
has_checksum	bit	指出頁面是否有總和檢查碼值的位元
總和檢查碼	int	儲存用來偵測資料損毀的總和檢查碼值
is_iam_pg	bit	指出頁面是否為 IAM 頁面的位元
is_mixed_ext	bit	指出是否在混合範圍中配置的位元
has_ghost_records	bit	指出頁面是否包含准刪除記錄的位元准刪除的記錄是已標示要刪除但尚未移除的記錄。
has_version_records	bit	指出頁面是否包含用於加速資料庫復原的版本記錄的位元
pfs_page_id	int	對應 PFS 頁面的頁面識別碼
pfs_is_allocated	bit	指出頁面是否在對應 PFS 頁面中標示為已配置的位元
pfs_alloc_percent	int	對應 PFS 位元組所指出的配置百分比
pfs_status	nvarchar(64)	PFS 位元組
pfs_status_desc	nvarchar(64)	PFS 位元組的描述
gam_page_id	int	對應 GAM 頁面的頁面識別碼
gam_status	bit	指出是否在 GAM 中配置的位元
gam_status_desc	nvarchar(64)	GAM 狀態位元的描述
sgam_page_id	int	對應 SGAM 頁面的頁面識別碼
sgam_status	bit	指出是否在 SGAM 中配置的位元
sgam_status_desc	nvarchar(64)	SGAM 狀態位元的描述
diff_map_page_id	int	對應差異點陣圖頁面的頁面識別碼
diff_status	bit	指出差異狀態是否已變更的位元
diff_status_desc	nvarchar(64)	差異狀態位元的描述
ml_map_page_id	int	對應最小記錄點陣圖頁面的頁面識別碼
ml_status	bit	指出頁面是否以最小方式記錄的位元
ml_status_desc	nvarchar(64)	最小記錄狀態位元的描述
prev_page_file_id	smallint	上一頁檔案識別碼
prev_page_page_id	int	上一頁頁面識別碼
next_page_file_id	smallint	下一頁檔案識別碼
next_page_page_id	int	下一頁頁面識別碼
fixed_length	smallint	固定大小資料列的長度
slot_count	smallint	位置的總數 (已使用及未使用) 對於資料頁面，此數相當於資料列數目。
ghost_rec_count	smallint	頁面上標示為准刪除的記錄數目准刪除的記錄是已標示要刪除但尚未移除的記錄。
free_bytes	smallint	頁面上的可用位元組數目
free_data_offset	int	資料區結尾的可用空間位移
reserved_bytes	smallint	所有交易所保留的可用位元組數目 (如果是堆積的話) 准刪除資料列的數目 (如果是索引分葉的話)
reserved_bytes_by_xdes_id	smallint	由 m_xdesID 提供給 m_reservedCnt 的空間僅供偵錯之用
xdes_id	nvarchar(64)	m_reserved 所提供的最新交易僅供偵錯之用

備註

sys.dm_db_page_info 動態管理函式會傳回頁面標頭中存在的資訊，例如 page_id、file_id、index_id、object_id 等等。此資訊對於疑難排解及偵錯各種效能 (鎖定和閂鎖爭用) 和損毀問題很有用。

sys.dm_db_page_info 在很多情況下可以用來代替 DBCC PAGE 陳述式，但其只會傳回頁面標頭資訊，而不會傳回頁面的內文。對於需要頁面全部內容的使用案例，仍然需要 DBCC PAGE。

與其他 DMV 搭配使用

sys.dm_db_page_info 的其中一個重要使用案例是將其與公開頁面資訊的其他 DMV 聯結。為了方便進行此使用案例，已新增了一個名為 page_resource 的新資料行，其以 8 位元組十六進位格式公開頁面資訊。此資料行已新增至 sys.dm_exec_requests 和 sys.sysprocesses，未來將會視需要新增至其他 DMV。

新的函式 sys.fn_PageResCracker 會採用 page_resource 作為輸入,並輸出包含 database_id、file_id 和 page_id 的單一資料列。然後，您可以使用此函式來促進 sys.dm_exec_requests 或 sys.sysprocesses 與 sys.dm_db_page_info 之間的聯結。

權限

需要資料庫中的 VIEW DATABASE STATE 權限。

SQL Server 2022 和更新版本的權限

需要資料庫上的 VIEW DATABASE PERFORMANCE STATE 權限。

範例

A. 顯示頁面的所有屬性

下列查詢會傳回一個資料列，其中包含指定 database_id、file_id、page_id 組合的所有頁面資訊，以及預設模式 ('LIMITED')

SELECT *
FROM sys.dm_db_page_info (5, 1, 15, DEFAULT);

B. 搭配其他 DMV 使用 sys.dm_db_page_info

當資料列包含非 Null page_resource 時，下列查詢會根據 sys.dm_exec_requests 所公開的 wait_resource 傳回一個資料列

SELECT page_info.*
FROM sys.dm_exec_requests AS d
CROSS APPLY sys.fn_PageResCracker(d.page_resource) AS r
CROSS APPLY sys.dm_db_page_info(r.db_id, r.file_id, r.page_id, 'LIMITED') AS page_info;