sp_spaceused (Transact-SQL)

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Den sp_spaceused system lagrade proceduren visar antingen:

• antalet rader, reserverat diskutrymme och diskutrymme som används av en tabell, indexerad vy eller Service Broker-kö i den aktuella databasen

• det reserverade diskutrymmet och som används av hela databasen

Transact-SQL syntaxkonventioner

Syntax

sp_spaceused
    [ [ @objname = ] N'objname' ]
    [ , [ @updateusage = ] 'updateusage' ]
    [ , [ @mode = ] 'mode' ]
    [ , [ @oneresultset = ] oneresultset ]
    [ , [ @include_total_xtp_storage = ] include_total_xtp_storage ]
[ ; ]

Argumentpunkter

För Azure Synapse Analytics and Analytics Platform System (PDW) sp_spaceused måste du ange namngivna parametrar (till exempel sp_spaceused (@objname= N'Table1');) i stället för att förlita sig på parametrarnas ordningstal.

[ @objname = ] N'objname'

Det kvalificerade eller icke-kvalificerade namnet på tabellen, den indexerade vyn eller kön för vilken information om utrymmesanvändning begärs. @objname är nvarchar(776), med standardvärdet NULL. Citattecken krävs endast om ett kvalificerat objektnamn har angetts. Om ett fullständigt kvalificerat objektnamn (inklusive ett databasnamn) anges måste databasnamnet vara namnet på den aktuella databasen.

Om @objname inte anges returneras resultaten för hela databasen.

[ @updateusage = ] "updateusage"

Anger DBCC UPDATEUSAGE att ska köras för att uppdatera information om utrymmesanvändning. @updateusage är varchar(5), med standardvärdet false. När @objname inte har angetts körs -instruktionen på hela databasen. Annars körs -instruktionen på @objname. Värden kan vara true eller false.

[ @mode = ] "läge"

Anger resultatets omfattning. För en utsträckt tabell eller databas kan du med parametern @mode inkludera eller exkludera fjärrdelen av objektet. Mer information finns i Stretch Database.

@mode är varchar(11) och kan vara ett av dessa värden.

[ @oneresultset = ] oneresultset

Anger om en enskild resultatuppsättning ska returneras. @oneresultset är lite och kan vara ett av följande värden:

[ @include_total_xtp_storage = ] include_total_xtp_storage

Gäller för: SQL Server 2017 (14.x) och senare versioner och SQL Database

När @oneresultset är inställt på 1avgör den här parametern om den enskilda resultatuppsättningen innehåller kolumner för MEMORY_OPTIMIZED_DATA lagring. @include_total_xtp_storage är bit, med standardvärdet 0. Om 1inkluderas XTP-kolumner i resultatuppsättningen.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Om @objname utelämnas och värdet för @oneresultset är 0returneras följande resultatuppsättningar för att ange aktuell databasstorleksinformation.

Om @objname utelämnas och värdet för @oneresultset är 1returneras följande enskilda resultatuppsättning för att ange aktuell databasstorleksinformation.

Om @objname anges returneras följande resultatuppsättning för det angivna objektet.

Det här läget är standard när inga parametrar har angetts. Följande resultatuppsättningar returneras med information om storleken på diskdatabasen.

Utrymme som används av tabeller i databasen. Den här resultatuppsättningen återspeglar inte minnesoptimerade tabeller eftersom det inte finns någon redovisning per tabell av diskanvändning:

Följande resultatuppsättning returneras endast om databasen har en MEMORY_OPTIMIZED_DATA filgrupp med minst en container:

Om @objname utelämnas är 1värdet för @oneresultset , och @include_total_xtp_storage är 1returneras följande enskilda resultatuppsättning för att ange aktuell databasstorleksinformation. Om @include_total_xtp_storage är 0 (standard) utelämnas de tre sista kolumnerna.

¹ Inkluderas endast om @include_total_xtp_storage är inställt på 1.

Anmärkningar

Värdet database_size är vanligtvis större än summan av reservedunallocated space + eftersom det innehåller storleken på loggfiler, men reserved och unallocated_space överväg endast datasidor. I vissa fall med Azure Synapse Analytics kanske den här instruktionen inte är sann.

Sidor som används av XML-index och fulltextindex ingår i index_size båda resultatuppsättningarna. När @objname anges räknas även sidorna för XML-indexen och fulltextindexen för objektet i totalsumman reserved och index_size resultaten.

Om utrymmesanvändningen beräknas för en databas eller ett objekt som är ett rumsligt index, inkluderar kolumnerna med utrymmesstorlek, till exempel database_size, reservedoch index_size, storleken på det rumsliga indexet.

När @updateusage anges söker SQL Server Database Engine igenom datasidorna i databasen och gör eventuella nödvändiga korrigeringar av vyerna sys.allocation_units och sys.partitions katalogvyerna för lagringsutrymmet som används av varje tabell. Det finns vissa situationer, till exempel när ett index har släppts, när utrymmesinformationen för tabellen kanske inte är aktuell. @updateusage kan ta lite tid att köra på stora tabeller eller databaser. Använd endast @updateusage när du misstänker att felaktiga värden returneras och när processen inte har en negativ effekt på andra användare eller processer i databasen. Om du vill DBCC UPDATEUSAGE kan du köra separat.

Behörigheter

Behörighet att köra sp_spaceused beviljas till den offentliga rollen. Endast medlemmar i den db_owner fasta databasrollen kan ange parametern @updateusage.

Exempel

A. Visa diskutrymmesinformation om en tabell

I följande exempel rapporterar vi diskutrymmesinformation för Vendor tabellen och dess index.

USE AdventureWorks2022;
GO

EXECUTE sp_spaceused N'Purchasing.Vendor';
GO

B. Visa uppdaterad utrymmesinformation om en databas

I följande exempel sammanfattas det utrymme som används i den aktuella databasen och den valfria parametern @updateusage för att säkerställa att aktuella värden returneras.

USE AdventureWorks2022;
GO

EXECUTE sp_spaceused @updateusage = N'TRUE';
GO

C. Visa information om utrymmesanvändning om fjärrtabellen som är associerad med en Stretch-aktiverad tabell

I följande exempel sammanfattas det utrymme som används av fjärrtabellen som är associerad med en Stretch-aktiverad tabell med hjälp av argumentet @mode för att ange fjärrmålet. Mer information finns i Stretch Database.

USE StretchedAdventureWorks2022;
GO

EXECUTE sp_spaceused N'Purchasing.Vendor', @mode = 'REMOTE_ONLY';

D. Visa information om utrymmesanvändning för en databas i en enda resultatuppsättning

I följande exempel sammanfattas utrymmesanvändningen för den aktuella databasen i en enda resultatuppsättning.

USE AdventureWorks2022;
GO

EXECUTE sp_spaceused @oneresultset = 1;

E. Visa information om utrymmesanvändning för en databas med minst en MEMORY_OPTIMIZED filgrupp i en enda resultatuppsättning

I följande exempel sammanfattas utrymmesanvändningen för den aktuella databasen med minst en MEMORY_OPTIMIZED filgrupp i en enda resultatuppsättning.

USE WideWorldImporters;
GO

EXECUTE sp_spaceused
    @updateusage = 'FALSE',
    @mode = 'ALL',
    @oneresultset = '1',
    @include_total_xtp_storage = '1';
GO

F. Visa information om utrymmesanvändning för ett MEMORY_OPTIMIZED tabellobjekt i en databas

I följande exempel sammanfattas utrymmesanvändningen för ett MEMORY_OPTIMIZED tabellobjekt i den aktuella databasen med minst en MEMORY_OPTIMIZED filgrupp.

USE WideWorldImporters;
GO

EXECUTE sp_spaceused
    @objname = N'VehicleTemperatures',
    @updateusage = 'FALSE',
    @mode = 'ALL',
    @oneresultset = '0',
    @include_total_xtp_storage = '1';
GO

Relaterat innehåll

• SKAPA INDEX (Transact-SQL)
• SKAPA TABELL (Transact-SQL)
• DBCC UPDATEUSAGE (Transact-SQL)
• Service Broker
• sys.allocation_units (Transact-SQL)
• sys.indexes (Transact-SQL)
• sys.index_columns (Transact-SQL)
• sys.objects (Transact-SQL)
• sys.partitions (Transact-SQL)
• System sparade procedurer (Transact-SQL)