sp_spaceused (Transact-SQL)

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Die sp_spaceused gespeicherte Systemprozedur zeigt eine der folgenden Optionen an:

• Die Anzahl von Zeilen, reserviertem Speicherplatz und Speicherplatz, der von einer Tabelle, indizierten Ansicht oder Dienstbrokerwarteschlange in der aktuellen Datenbank verwendet wird

• der reservierte und von der gesamten Datenbank verwendete Speicherplatz

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

Für Azure Synapse Analytics and Analytics Platform System (PDW) sp_spaceused müssen benannte Parameter (z. B sp_spaceused (@objname= N'Table1');. ) angegeben werden, anstatt die Ordnungsposition von Parametern zu verwenden.

[ @objname = ] N'objname'

Der qualifizierte oder nicht qualifizierte Name der Tabelle, der indizierten Ansicht oder der Warteschlange, für die Informationen zur Speicherplatznutzung angefordert werden. @objname ist nvarchar(776), mit einem Standardwert von NULL. Anführungszeichen sind nur erforderlich, wenn ein qualifizierter Objektname angegeben wird. Bei Angabe eines vollqualifizierten Objektnamens (einschließlich eines Datenbanknamens) muss der Datenbankname der Name der aktuellen Datenbank sein.

Wenn @objname nicht angegeben ist, werden die Ergebnisse für die gesamte Datenbank zurückgegeben.

[ @updateusage = ] 'updateusage'

Gibt an, DBCC UPDATEUSAGE dass informationen zur Speicherplatznutzung aktualisiert werden sollen. @updateusage ist varchar(5) mit einem Standardwert von false. Wenn @objname nicht angegeben ist, wird die Anweisung für die gesamte Datenbank ausgeführt. Andernfalls wird die Anweisung auf @objname ausgeführt. Werte können true oder false sein.

[ @mode = ] 'Mode'

Gibt den Bereich der Ergebnisse an. Bei einer gestreckten Tabelle oder Datenbank können Sie mit dem @mode-Parameter den Remoteteil des Objekts einschließen oder ausschließen. Weitere Informationen finden Sie unter Stretch Database.

@mode ist varchar(11) und kann einer dieser Werte sein.

[ @oneresultset = ] oneresultset

Gibt an, ob ein einzelnes Resultset zurückgegeben werden soll. @oneresultset ist Bit und kann einer der folgenden Werte sein:

[ @include_total_xtp_storage = ] include_total_xtp_storage

Gilt für: SQL Server 2017 (14.x) und höhere Versionen und SQL-Datenbank

Wenn @oneresultset auf 1 festgelegt ist, bestimmt dieser Parameter, ob das einzelne Resultset Spalten für MEMORY_OPTIMIZED_DATA den Speicher enthält. @include_total_xtp_storage ist bit, mit einem Standardwert von 0. If 1, XTP columns are included in the resultset.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Wenn @objname ausgelassen wird und der Wert von @oneresultset lautet 0, werden die folgenden Resultsets zurückgegeben, um aktuelle Datenbankgrößeninformationen bereitzustellen.

Wenn @objname ausgelassen wird und der Wert von @oneresultset ist 1, wird der folgende einzelne Resultset zurückgegeben, um aktuelle Datenbankgrößeninformationen bereitzustellen.

Wenn @objname angegeben ist, wird das folgende Resultset für das angegebene Objekt zurückgegeben.

Dieser Modus ist die Standardeinstellung, wenn keine Parameter angegeben werden. Die folgenden Resultsets werden zurückgegeben, die Informationen zur Größe der Datenträgerdatenbank angeben.

Platz, der von Tabellen in der Datenbank verwendet wird. Dieses Resultset spiegelt keine speicheroptimierten Tabellen wider, da keine Datenträgernutzung pro Tabelle vorhanden ist:

Das folgende Resultset wird nur zurückgegeben , wenn die Datenbank über eine MEMORY_OPTIMIZED_DATA Dateigruppe mit mindestens einem Container verfügt:

Wenn @objname nicht angegeben wird, lautet 1der Wert @oneresultset und @include_total_xtp_storage ist1, wird das folgende einzelne Resultset zurückgegeben, um aktuelle Datenbankgrößeninformationen bereitzustellen. Wenn @include_total_xtp_storage ist 0 (Standard), werden die letzten drei Spalten weggelassen.

¹ Nur enthalten, wenn @include_total_xtp_storage auf 1.

Hinweise

Der database_size Wert ist im Allgemeinen größer als die Summe, da reservedunallocated space + er die Größe von Protokolldateien enthält, aber unallocated_space reserved nur Datenseiten in Betracht ziehen kann. In einigen Fällen mit Azure Synapse Analytics ist diese Aussage möglicherweise nicht wahr.

Seiten, die von XML-Indizes und Volltextindizes verwendet werden, sind für beide Resultsets enthalten index_size . Wenn @objname angegeben wird, werden die Seiten für die XML-Indizes und Volltextindizes für das Objekt ebenfalls in der Summe reserved und index_size den Ergebnissen gezählt.

Wenn die Raumnutzung für eine Datenbank oder ein Objekt, das ein räumlicher Index ist, berechnet wird, enthalten die Spalten der Raumgröße, z database_size. B. , reservedund index_sizedie Größe des räumlichen Indexes.

Wenn @updateusage angegeben wird, überprüft die SQL Server-Datenbank-Engine die Datenseiten in der Datenbank und nimmt alle erforderlichen Korrekturen an den sys.allocation_units Ansichten und sys.partitions Katalogen hinsichtlich des von jeder Tabelle verwendeten Speicherplatzes vor. Es gibt einige Situationen, z. B. nach dem Ablegen eines Indexes, wenn die Leerzeicheninformationen für die Tabelle möglicherweise nicht aktuell sind. @updateusage können einige Zeit in großen Tabellen oder Datenbanken ausführen. Verwenden Sie @updateusage nur, wenn Sie vermuten, dass falsche Werte zurückgegeben werden, und wenn der Prozess keine negativen Auswirkungen auf andere Benutzer oder Prozesse in der Datenbank hat. Falls bevorzugt, DBCC UPDATEUSAGE kann separat ausgeführt werden.

Berechtigungen

Die Berechtigung zum Ausführen sp_spaceused wird der öffentlichen Rolle gewährt. Nur Mitglieder der festen Datenbankrolle db_owner können den Parameter @updateusage angeben.

Beispiele

A. Anzeigen von Speicherplatzinformationen zu einer Tabelle

Im folgenden Beispiel werden Speicherplatzinformationen für die Vendor-Tabelle und deren Indizes abgerufen.

USE AdventureWorks2022;
GO
EXEC sp_spaceused N'Purchasing.Vendor';
GO

B. Anzeigen aktualisierter Speicherplatzinformationen zu einer Datenbank

Im folgenden Beispiel wird der in der aktuellen Datenbank verwendete Platz zusammengefasst und der optionale Parameter @updateusage verwendet, um sicherzustellen, dass aktuelle Werte zurückgegeben werden.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @updateusage = N'TRUE';
GO

C. Anzeigen von Platznutzungsinformationen zur Remotetabelle, die einer Stretch-aktivierten Tabelle zugeordnet ist

Im folgenden Beispiel wird der von der Remotetabelle verwendete Platz zusammengefasst, der einer Stretch-fähigen Tabelle zugeordnet ist, indem das argument @mode verwendet wird, um das Remoteziel anzugeben. Weitere Informationen finden Sie unter Stretch Database.

USE StretchedAdventureWorks2022;
GO

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

D: Anzeigen von Platznutzungsinformationen für eine Datenbank in einem einzelnen Resultset

Im folgenden Beispiel wird die Speicherplatznutzung für die aktuelle Datenbank in einem einzigen Resultset zusammengefasst.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @oneresultset = 1;

E. Anzeigen von Speicherplatznutzungsinformationen für eine Datenbank mit mindestens einer MEMORY_OPTIMIZED Dateigruppe in einem einzigen Resultset

Im folgenden Beispiel wird die Speicherplatznutzung für die aktuelle Datenbank mit mindestens einer MEMORY_OPTIMIZED Dateigruppe in einem einzigen Resultset zusammengefasst.

USE WideWorldImporters
GO

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

F. Anzeigen von Platznutzungsinformationen für ein MEMORY_OPTIMIZED Tabellenobjekt in einer Datenbank

Im folgenden Beispiel wird die Speicherplatznutzung für ein MEMORY_OPTIMIZED Tabellenobjekt in der aktuellen Datenbank mit mindestens einer MEMORY_OPTIMIZED Dateigruppe zusammengefasst.

USE WideWorldImporters
GO

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

Zugehöriger Inhalt

• CREATE INDEX (Transact-SQL)
• CREATE TABLE (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)
• Gespeicherte Systemprozeduren (Transact-SQL)