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) Service Pack 2 и SQL Server 2016 (13.x) Service Pack 1.

Syntax

sys.dm_db_incremental_stats_properties (object_id, stats_id)

Аргументы

object_id
Это идентификатор объекта в текущей базе данных, для которого запрашиваются свойства одной из его инкрементальных статистик. object_id имеет тип int.

stats_id
Идентификатор статистики для указанного аргумента object_id. Идентификатор статистики может быть получен из динамического административного представления sys.stats . stats_id имеет тип int.

Возвращаемая таблица

Название столбца Тип данных Описание
object_id int ID объекта (таблицы), для которого можно вернуть свойства объекта статистики.
stats_id int Идентификатор объекта статистики. Уникально внутри таблицы. Дополнительные сведения см. в статье sys.stats (Transact-SQL).
partition_number int Число разбиения, содержащего часть таблицы.
last_updated datetime2 Дата и время последнего обновления объекта статистики. Дополнительные сведения см. в подразделе Примечания на этой странице.
строки bigint Общее количество строк в таблице на момент последнего обновления статистики. Если статистика отфильтрована или соответствует отфильтрованному индексу, количество строк может быть меньше, чем количество строк в таблице.
rows_sampled bigint Общее количество строк, выбранных для статистических вычислений.
steps int Число шагов в гистограмме. Дополнительные сведения см. в разделе DBCC SHOW_STATISTICS (Transact-SQL).
unfiltered_rows bigint Общее количество строк в таблице до применения критерия фильтра (для отфильтрованной статистики). Если статистика не отфильтрована, то unfiltered_rows равно значению, которое возвращается в столбце rows.
modification_counter bigint Общее количество изменений в начальном столбце статистики (на основе которого строится гистограмма) с момента последнего обновления статистики.

Этот столбец не содержит информации для таблиц, оптимизированных по памяти.

Замечания

sys.dm_db_incremental_stats_properties возвращает пустой набор строк при любом из следующих условий:

  • object_id или stats_id NULL.
  • Указанный объект не находится или не соответствует таблице с инкрементальной статистикой.
  • Указанный идентификатор статистики не соответствует имеющейся статистике для указанного идентификатора объекта статистики.
  • Текущий пользователь не имеет разрешений на просмотр объекта статистики.

Это поведение позволяет безопасно использовать при sys.dm_db_incremental_stats_properties кросс-приложении к строкам в таких видах sys.objects , как и sys.stats. Этот метод может возвращать свойства для статистики, соответствующих каждой порции. Чтобы увидеть свойства объединённой статистики по всем разделам, используйте sys.dm_db_stats_properties.

Дата обновления статистики хранится в большом двоичном объекте статистики вместе с гистограммой и вектором плотности, а не в метаданных. Если данные не считываются для создания статистических данных, большой двоичный объект статистики не создается, дата недоступна, а столбец last_updated имеет значение NULL. Это происходит с отфильтрованной статистикой, для которой предикат не возвращает ни одной строки, или с новыми пустыми таблицами.

Permissions

Требуется наличие у пользователя разрешения на выбор столбцов статистики либо то, чтобы пользователь был владельцем таблицы или членом предопределенной роли сервера sysadmin, предопределенной роли базы данных db_owner или предопределенной роли базы данных db_ddladmin.

Examples

А. Простой пример

Следующий пример возвращает статистику для таблицы, 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)

  • Last updated on