• [アーティクル]

STATS_DATE (Transact-SQL)

テーブルまたはインデックス付きビューの統計の最終更新日を返します。

統計の更新の詳細については、「クエリのパフォーマンスを向上させるための統計の使用」を参照してください。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

STATS_DATE ( object_id , stats_id )

引数

  • object_id
    統計を含むテーブルまたはインデックス付きビューの ID。

  • stats_id
    統計オブジェクトの ID。

戻り値の型

成功した場合は datetime を返します。エラーが発生した場合は NULL を返します。

説明

システム関数は、選択リストや WHERE 句のほか、式が許可される場所であればどこでも使用できます。

権限

db_owner 固定データベース ロールのメンバシップか、テーブルまたはインデックス付きビューのメタデータを表示する権限が必要です。詳細については、「メタデータ表示のトラブルシューティング」を参照してください。

例

A. テーブルの統計の最終更新日を返す

次の例では、Person.Address テーブルの各統計オブジェクトの最終更新日を返します。

USE AdventureWorks;
GO
SELECT name AS stats_name, 
    STATS_DATE(object_id, stats_id) AS statistics_update_date
FROM sys.stats 
WHERE object_id = OBJECT_ID('Person.Address');
GO

統計がインデックスに対応する場合、sys.stats カタログ ビューの stats_id の値は、sys.indexes カタログ ビューの index_id の値と同一になります。このため、次に示すクエリは上のクエリと同じ結果を返します。統計がインデックスに対応しない場合、統計は sys.stats の結果には含まれますが、sys.indexes の結果には含まれません。

USE AdventureWorks;
GO
SELECT name AS index_name, 
    STATS_DATE(object_id, index_id) AS statistics_update_date
FROM sys.indexes 
WHERE object_id = OBJECT_ID('Person.Address');
GO

変更履歴

変更内容

より正確な内容にするためにドキュメント全体を修正しました。

「クエリのパフォーマンスを向上させるための統計の使用」の統計に関する新しい記述を参照しています。