EnumStatistics Method (SQL-DMO)

The EnumStatistics method returns a QueryResults object enumerating index statistics used to support Microsoft® SQL Server™ query optimization.

Applies To

Index Object

Syntax

object.EnumStatistics() as QueryResults

Part Description
object Expression that evaluates to an object in the Applies To list

Returns

A QueryResults object containing three result sets. The first result set describes index statistics structure and age and is defined by these columns.

Column Data type Description
Updated nvarchar(21) Date and time of most recent update
Rows integer Number of rows in the table
Rows Sampled integer Number of rows sampled for statistics data
Steps integer Number of distribution steps
Density real Selectivity of the index
Average key length real Average length of an index row

The second result set describes index density and is defined by these columns.

Column Data type Description
All density real Selectivity of the column(s) listed in Columns
Columns nvarchar(129) Column(s) participating in index

The third result set enumerates histogram values and is defined by these columns.

Column Data type Description
Steps nvarchar(6) Histogram values in the current distribution statistics

Remarks

Statistics are calculated for an index when the index is first used in query optimization or at user direction. Statistics are updated automatically at configurable intervals. When statistics have not been calculated on an index, the EnumStatistics method succeeds but returns no result sets.

Prototype (C/C++)

HRESULT EnumStatistics(
LPSQLDMOQUERYRESULTS* ppResults);

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.