sp_spaceused (Transact-SQL)

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

La sp_spaceused stored procedure di sistema visualizza:

• numero di righe, spazio su disco riservato e spazio su disco usato da una tabella, una vista indicizzata o una coda di Service Broker nel database corrente

• spazio su disco riservato e usato dall'intero database

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

Per Azure Synapse Analytics and Analytics Platform System (PDW), sp_spaceused è necessario specificare parametri denominati (ad esempio sp_spaceused (@objname= N'Table1');), anziché basarsi sulla posizione ordinale dei parametri.

[ @objname = ] N'objname'

Nome qualificato o non qualificato della tabella, della vista indicizzata o della coda per cui vengono richieste informazioni sull'utilizzo dello spazio. @objname è nvarchar(776), con il valore predefinito NULL. Le virgolette sono necessarie solo se viene specificato un nome di oggetto completo. Se viene specificato un nome di oggetto completo, ovvero contenente un nome di database, il nome del database deve essere quello del database corrente.

Se non viene specificato @objname , vengono restituiti i risultati per l'intero database.

[ @updateusage = ] 'updateusage'

Indica DBCC UPDATEUSAGE che deve essere eseguito per aggiornare le informazioni sull'utilizzo dello spazio. @updateusage è varchar(5), con il valore predefinito false. Quando @objname non viene specificato, l'istruzione viene eseguita nell'intero database. In caso contrario, l'istruzione viene eseguita in @objname. I valori possono essere true o false.

[ @mode = ] 'mode'

Indica l'ambito dei risultati. Per una tabella o un database esteso, il parametro @mode consente di includere o escludere la parte remota dell'oggetto. Per ulteriori informazioni, vedere Stretch Database.

@mode è varchar(11) e può essere uno di questi valori.

[ @oneresultset = ] oneresultset

Indica se restituire un singolo set di risultati. @oneresultset è bit e può essere uno di questi valori:

[ @include_total_xtp_storage = ] include_total_xtp_storage

Si applica a: SQL Server 2017 (14.x) e versioni successive e database SQL

Quando @oneresultset è impostato su 1, questo parametro determina se il singolo set di risultati include colonne per MEMORY_OPTIMIZED_DATA l'archiviazione. @include_total_xtp_storage è bit, con il valore predefinito 0. Se 1, le colonne XTP vengono incluse nel set di risultati.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Se @objname viene omesso e il valore di @oneresultset è 0, vengono restituiti i set di risultati seguenti per fornire informazioni sulle dimensioni correnti del database.

Se @objname viene omesso e il valore di @oneresultset è 1, viene restituito il set di risultati singolo seguente per fornire informazioni sulle dimensioni correnti del database.

Se si specifica @objname , viene restituito il set di risultati seguente per l'oggetto specificato.

Questa modalità è l'impostazione predefinita, quando non vengono specificati parametri. I set di risultati seguenti vengono restituiti dettagli sulle informazioni sulle dimensioni del database su disco.

Spazio utilizzato dalle tabelle nel database. Questo set di risultati non riflette le tabelle ottimizzate per la memoria, perché non esiste alcuna contabilità per tabella dell'utilizzo del disco:

Il set di risultati seguente viene restituito solo se il database ha un MEMORY_OPTIMIZED_DATA filegroup con almeno un contenitore:

Se @objname viene omesso, il valore di @oneresultset è 1e @include_total_xtp_storage è 1, viene restituito il set di risultati singolo seguente per fornire informazioni sulle dimensioni correnti del database. Se @include_total_xtp_storage è 0 (impostazione predefinita), le ultime tre colonne vengono omesse.

¹ È incluso solo se @include_total_xtp_storage è impostato su 1.

Osservazioni:

Il database_size valore è in genere maggiore della somma di perché include le dimensioni dei file di reservedunallocated space + log, ma considerare unallocated_space reserved solo le pagine di dati. In alcuni casi con Azure Synapse Analytics, questa istruzione potrebbe non essere vera.

Le pagine utilizzate dagli indici XML e dagli indici full-text sono incluse in index_size per entrambi i set di risultati. Quando si specifica @objname , vengono conteggiate anche le pagine per gli indici XML e gli indici full-text per l'oggetto nel totale reserved e index_size nei risultati.

Se l'utilizzo dello spazio viene calcolato per un database o un oggetto che è un indice spaziale, le colonne di dimensioni spazio, ad esempio database_size, reservede index_size, includono le dimensioni dell'indice spaziale.

Quando si specifica @updateusage, SQL Server motore di database analizza le pagine di dati nel database e apporta eventuali correzioni necessarie alle viste del sys.allocation_units catalogo e sys.partitions relative allo spazio di archiviazione usato da ogni tabella. Esistono alcune situazioni, ad esempio, dopo l'eliminazione di un indice, quando le informazioni sullo spazio per la tabella potrebbero non essere correnti. @updateusage può richiedere del tempo per l'esecuzione in tabelle o database di grandi dimensioni. Usare @updateusage solo quando si sospetta che vengano restituiti valori non corretti e quando il processo non ha effetti negativi su altri utenti o processi nel database. Se preferito, DBCC UPDATEUSAGE può essere eseguito separatamente.

Autorizzazioni

L'autorizzazione per l'esecuzione sp_spaceused viene concessa al ruolo pubblico . Solo tramite i membri del ruolo predefinito del database db_owner può essere specificato il parametro @updateusage .

Esempi

R. Visualizzare le informazioni sullo spazio su disco su una tabella

Nell'esempio seguente vengono visualizzate informazioni relative allo spazio su disco per la tabella Vendor e i relativi indici.

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

B. Visualizzare le informazioni sullo spazio aggiornato su un database

Nell'esempio seguente viene riepilogato lo spazio utilizzato nel database corrente e viene utilizzato il parametro facoltativo @updateusage per assicurarsi che vengano restituiti i valori correnti.

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

C. Visualizzare le informazioni sull'utilizzo dello spazio sulla tabella remota associata a una tabella abilitata per l'estensione

Nell'esempio seguente viene riepilogato lo spazio utilizzato dalla tabella remota associata a una tabella abilitata per l'estensione usando l'argomento @mode per specificare la destinazione remota. Per altre informazioni, vedere Stretch Database.

USE StretchedAdventureWorks2022;
GO

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

D. Visualizzare le informazioni sull'utilizzo dello spazio per un database in un singolo set di risultati

Nell'esempio seguente viene riepilogato l'utilizzo dello spazio per il database corrente in un singolo set di risultati.

USE AdventureWorks2022;
GO
EXEC sp_spaceused @oneresultset = 1;

E. Visualizzare le informazioni sull'utilizzo dello spazio per un database con almeno un MEMORY_OPTIMIZED file group in un singolo set di risultati

Nell'esempio seguente viene riepilogato l'utilizzo dello spazio per il database corrente con almeno un MEMORY_OPTIMIZED filegroup in un singolo set di risultati.

USE WideWorldImporters
GO

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

F. Visualizzare le informazioni sull'utilizzo dello spazio per un oggetto tabella MEMORY_OPTIMIZED in un database

Nell'esempio seguente viene riepilogato l'utilizzo dello spazio per un MEMORY_OPTIMIZED oggetto tabella nel database corrente con almeno un MEMORY_OPTIMIZED filegroup.

USE WideWorldImporters
GO

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

Contenuto correlato

• 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)
• Stored procedure di sistema (Transact-SQL)