sys.dm_db_incremental_stats_properties(Transact-SQL)

適用於:SQL Server

回傳目前 SQL Server 資料庫中指定資料庫物件(資料表)的增量統計屬性。 (包含分割數)的使用 sys.dm_db_incremental_stats_properties 方式與 sys.dm_db_stats_properties 非增量統計的使用方式相似。

此功能於 SQL Server 2014(12.x)服務包 2 及 SQL Server 2016(13.x)服務包 1 中引入。

Syntax

sys.dm_db_incremental_stats_properties (object_id, stats_id)  

引數

object_id
是目前資料庫中請求其增量統計屬性的物件的 ID。 @object_idint

stats_id
這是指定 object_id之統計資料的識別碼。 您可以從 sys.stats 動態管理檢視取得統計資料識別碼。 stats_idint

傳回的資料表

欄位名稱 資料類型 Description
object_id int 物件(資料表)的 ID,用以回傳統計物件的屬性。
stats_id int 統計資料物件的識別碼。 在表格中是唯一的。 如需詳細資訊,請參閱 sys.stats (Transact-SQL)
partition_number int 包含表格部分的分割編號。
last_updated datetime2 上次更新統計數據物件的日期和時間。 如需詳細資訊,請參閱此頁的備註一節。
rows bigint 統計數據最後更新時的總列數。 如果篩選了統計資料或是統計資料對應至篩選過的索引,此資料列數可能會少於資料表中的資料列數。
rows_sampled bigint 針對統計資料計算進行取樣的資料列總數。
steps int 長條圖中的步驟數。 如需詳細資訊,請參閱 DBCC SHOW_STATISTICS (Transact-SQL)
unfiltered_rows bigint 套用篩選表達式之前,數據表中的數據列總數(適用於篩選的統計數據)。 如果未篩選統計數據,unfiltered_rows等於數據列數據行中傳回的值。
modification_counter bigint 自上次更新統計數據以來,前置統計數據數據行的修改總數(直方圖建置所在的數據行)。

此欄位不包含記憶體優化資料表的資訊。

備註

sys.dm_db_incremental_stats_properties 在以下任一條件下,回傳一個空的行集:

  • object_idstats_id 為 NULL。
  • 指定的物件找不到,或不對應於具有增量統計的表格。
  • 指定的統計數據識別碼不會對應至指定物件標識碼的現有統計數據。
  • 目前用戶沒有檢視統計數據對象的許可權。

此行為允許在交叉應用於視圖列(如 sys.dm_db_incremental_stats_propertiessys.objects)時安全使用 sys.stats 。 此方法可回傳對應每個分割統計量的屬性。 要查看合併統計數據在所有分割間的合併屬性,請使用sys.dm_db_stats_properties。

統計資料更新日期儲存在統計資料 Blob 物件中,其中還有長條圖密度向量,不是儲存在中繼資料中。 未讀取任何數據以產生統計數據數據時,不會建立統計數據 Blob、無法使用日期,且 last_updated 數據行為 NULL。 這是已篩選統計資料的情況,其中述詞未傳回任何資料列,或為新的空白資料表的情況。

許可

要求使用者對於統計資料資料行擁有選取權限,或是使用者擁有資料表,或使用者是 sysadmin 固定伺服器角色、db_owner 固定資料庫角色或 db_ddladmin 固定資料庫角色的成員。

Examples

A. 簡單範例

以下範例回傳主題「建立分割資料表與索引」中描述的PartitionTable統計資料。

SELECT * FROM sys.dm_db_incremental_stats_properties (object_id('PartitionTable'), 1);

更多使用建議請參見 sys.dm_db_stats_properties

另請參閱

DBCC SHOW_STATISTICS (Transact-SQL)
sys.stats (Transact-SQL)
物件相關的動態管理檢視和函數 (Transact-SQL)
動態管理檢視和函數 (Transact-SQL)
sys.dm_db_stats_properties
sys.dm_db_stats_histogram (Transact-SQL)