sys.dm_db_incremental_stats_properties (T-SQL)

Artikel
08/21/2023

Berlaku untuk:SQL Server

Mengembalikan properti statistik inkremental untuk objek database (tabel) yang ditentukan dalam database SQL Server saat ini. Penggunaan sys.dm_db_incremental_stats_properties (yang berisi nomor partisi) mirip sys.dm_db_stats_properties dengan yang digunakan untuk statistik non-inkremental.

Fungsi ini diperkenalkan dalam Paket Layanan SQL Server 2014 (12.x) 2 dan SQL Server 2016 (13.x) Paket Layanan 1.

Sintaks

sys.dm_db_incremental_stats_properties (object_id, stats_id)

Argumen

object_id
Adalah ID objek dalam database saat ini yang propertinya diminta dari salah satu statistik inkrementalnya. object_id int.

stats_id
Adalah ID statistik untuk object_id yang ditentukan. ID statistik dapat diperoleh dari tampilan manajemen dinamis sys.stats . stats_id int.

Tabel Dikembalikan

Nama kolom	Jenis data	Deskripsi
object_id	int	ID objek (tabel) untuk mengembalikan properti objek statistik.
stats_id	int	ID objek statistik. Unik dalam tabel. Untuk informasi selengkapnya, lihat sys.stats (Transact-SQL).
partition_number	int	Jumlah partisi yang berisi bagian tabel.
last_updated	datetime2	Tanggal dan waktu objek statistik terakhir diperbarui. Untuk informasi selengkapnya, lihat bagian Keterangan di halaman ini.
baris	bigint	Jumlah total baris dalam tabel saat statistik terakhir diperbarui. Jika statistik difilter atau sesuai dengan indeks yang difilter, jumlah baris mungkin kurang dari jumlah baris dalam tabel.
rows_sampled	bigint	Jumlah total baris yang diambil sampelnya untuk perhitungan statistik.
langkah-langkah	int	Jumlah langkah dalam histogram. Untuk informasi selengkapnya, lihat SHOW_STATISTICS DBCC (Transact-SQL).
unfiltered_rows	bigint	Jumlah total baris dalam tabel sebelum menerapkan ekspresi filter (untuk statistik yang difilter). Jika statistik tidak difilter, unfiltered_rows sama dengan nilai yang dikembalikan di kolom baris.
modification_counter	bigint	Jumlah total modifikasi untuk kolom statistik utama (kolom tempat histogram dibangun) sejak terakhir kali statistik diperbarui. Kolom ini tidak berisi informasi untuk tabel yang dioptimalkan memori.

Keterangan

sys.dm_db_incremental_stats_properties mengembalikan set baris kosong di bawah salah satu kondisi berikut:

object_id atau stats_id null.
Objek yang ditentukan tidak ditemukan atau tidak sesuai dengan tabel dengan statistik inkremental.
ID statistik yang ditentukan tidak sesuai dengan statistik yang ada untuk ID objek yang ditentukan.
Pengguna saat ini tidak memiliki izin untuk melihat objek statistik.

Perilaku ini memungkinkan penggunaan sys.dm_db_incremental_stats_properties yang aman ketika silang diterapkan ke baris dalam tampilan seperti sys.objects dan sys.stats. Metode ini dapat mengembalikan properti untuk statistik yang sesuai dengan setiap partisi. Untuk melihat properti untuk statistik gabungan yang digabungkan di semua partisi, gunakan sys.dm_db_stats_properties sebagai gantinya.

Tanggal pembaruan statistik disimpan dalam objek blob statistik bersama dengan histogram dan vektor kepadatan, bukan dalam metadata. Ketika tidak ada data yang dibaca untuk menghasilkan data statistik, blob statistik tidak dibuat, tanggal tidak tersedia, dan kolom last_updated adalah NULL. Ini adalah kasus untuk statistik yang difilter yang predikatnya tidak mengembalikan baris apa pun, atau untuk tabel kosong baru.

Izin

Mengharuskan pengguna memilih izin pada kolom statistik atau pengguna memiliki tabel atau pengguna adalah anggota sysadmin peran server tetap, db_owner peran database tetap, atau db_ddladmin peran database tetap.

Contoh

J. Contoh sederhana

Contoh berikut mengembalikan statistik untuk tabel yang PartitionTable dijelaskan dalam topik Buat Tabel dan Indeks yang Dipartisi.

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

Untuk saran penggunaan tambahan, lihat sys.dm_db_stats_properties.

Lihat Juga

DBCC SHOW_STATISTICS (Transact-SQL)
sys.stats (Transact-SQL)
Tampilan dan Fungsi Manajemen Dinamis Terkait Objek (Transact-SQL)
Tampilan dan Fungsi Manajemen Dinamis (Transact-SQL)
sys.dm_db_stats_properties
sys.dm_db_stats_histogram (T-SQL)

Bagikan melalui