sys.dm_db_incremental_stats_properties (Transact-SQL)

Van toepassing op:SQL Server

Geeft eigenschappen van incrementele statistieken terug voor het opgegeven databaseobject (tabel) in de huidige SQL Server-database. Het gebruik van sys.dm_db_incremental_stats_properties (dat een partitienummer bevat) is vergelijkbaar met sys.dm_db_stats_properties wat wordt gebruikt voor niet-incrementele statistieken.

Deze functie werd geïntroduceerd in SQL Server 2014 (12.x) Service Pack 2 en SQL Server 2016 (13.x) Service Pack 1.

Syntax

sys.dm_db_incremental_stats_properties (object_id, stats_id)  

Argumenten

object_id
Is de ID van het object in de huidige database waarvoor eigenschappen van een van de incrementele statistieken worden opgevraagd. object_id is int.

stats_id
Is de ID van statistieken voor de gespecificeerde object_id. De statistieken-id kan worden verkregen vanuit de dynamische beheerweergave sys.stats . stats_id is int.

Tabel geretourneerd

Kolomnaam	Gegevenstype	Beschrijving
object_id	int	ID van het object (tabel) waarvoor de eigenschappen van het statistiekobject moeten worden teruggegeven.
stats_id	int	Id van het statistiekenobject. Is uniek binnen de tafel. Zie sys.stats (Transact-SQL)voor meer informatie.
partition_number	int	Nummer van de partitie die het deel van de tabel bevat.
last_updated	datetime2	Datum en tijd waarop het statistiekobject voor het laatst is bijgewerkt. Zie de sectie Opmerkingen op deze pagina voor meer informatie.
rijen	bigint	Totaal aantal rijen in de tabel toen de statistieken voor het laatst werden bijgewerkt. Als de statistieken worden gefilterd of overeenkomen met een gefilterde index, kan het aantal rijen kleiner zijn dan het aantal rijen in de tabel.
rows_sampled	bigint	Totaal aantal rijen dat is gesampleerd voor berekeningen van statistieken.
steps	int	Aantal stappen in het histogram. Zie DBCC-SHOW_STATISTICS (Transact-SQL)voor meer informatie.
unfiltered_rows	bigint	Totaal aantal rijen in de tabel voordat de filterexpressie wordt toegepast (voor gefilterde statistieken). Als statistieken niet worden gefilterd, is unfiltered_rows gelijk aan de waarde die in de kolom rijen terugkeert.
modification_counter	bigint	Totaal aantal aanpassingen voor de leidende statistiekkolom (de kolom waarop het histogram is gebouwd) sinds de laatste keer dat statistieken werden bijgewerkt. Deze kolom bevat geen informatie voor geheugen-geoptimaliseerde tabellen.

Opmerkingen

sys.dm_db_incremental_stats_properties geeft een lege rijset terug onder een van de volgende voorwaarden:

• object_id of stats_id is NULL.
• Het gespecificeerde object wordt niet gevonden of komt niet overeen met een tabel met incrementele statistieken.
• De opgegeven statistiek-ID komt niet overeen met bestaande statistieken voor de opgegeven object-ID.
• De huidige gebruiker heeft geen rechten om het statistiekobject te bekijken.

Dit gedrag maakt veilig gebruik mogelijk van sys.dm_db_incremental_stats_properties wanneer kruis toegepast op rijen in weergaven zoals sys.objects en sys.stats. Deze methode kan eigenschappen teruggeven voor de statistieken die overeenkomen met elke partitie. Om de eigenschappen van de samengevoegde statistieken over alle partities te combineren, gebruik in plaats daarvan de sys.dm_db_stats_properties.

De updatedatum van statistieken wordt samen met het histogram en de dichtheidsvector opgeslagen in het blobobject voor statistieken, niet in de metagegevens. Wanneer er geen data wordt gelezen om statistische data te genereren, wordt de statistiekblob niet aangemaakt, is de datum niet beschikbaar en is de kolom last_updated NUL. Dit geldt voor gefilterde statistieken waarbij het predicaat geen rijen teruggeeft, of voor nieuwe lege tabellen.

Permissions

Vereist dat de gebruiker selectierechten heeft op statistiekkolommen of dat de gebruiker de tabel bezit of lid is van de sysadmin vaste serverrol, de db_owner vaste databaserol of de db_ddladmin vaste databaserol.

Examples

A. Eenvoudig voorbeeld

Het volgende voorbeeld geeft de statistieken terug voor de PartitionTable tabel beschreven in het onderwerp Create Partitioned Tables and Indexes.

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

Voor aanvullende gebruikssuggesties, zie sys.dm_db_stats_properties.

Zie ook

DBCC-SHOW_STATISTICS (Transact-SQL)
sys.stats (Transact-SQL)
Objectgerelateerde dynamische beheerweergaven en -functies (Transact-SQL)
Dynamische beheerweergaven en -functies (Transact-SQL)
sys.dm_db_stats_properties
sys.dm_db_stats_histogram (Transact-SQL)