DBCC UPDATEUSAGE (Transact-SQL)

Articolo
04/26/2023

Si applica a: SQL Server Azure SQL Database Istanza gestita di SQL di Azure

Segnala e corregge le imprecisioni relative al conteggio delle pagine e delle righe nelle viste del catalogo. Queste inesattezze possono causare report di utilizzo dello spazio non corretti restituiti dalla stored procedure di sp_spaceused sistema.

Convenzioni della sintassi Transact-SQL

Sintassi

DBCC UPDATEUSAGE
(   { database_name | database_id | 0 }
    [ , { table_name | table_id | view_name | view_id }
    [ , { index_name | index_id } ] ]
) [ WITH [ NO_INFOMSGS ] [ , ] [ COUNT_ROWS ] ]

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 e versioni precedenti, vedere Documentazione delle versioni precedenti.

Argomenti

database_name | database_id | 0

Nome o ID del database per cui segnalare e correggere le statistiche di utilizzo dello spazio. Se si specifica 0, viene utilizzato il database corrente. I nomi dei database devono essere conformi alle regole per gli identificatori.

table_name | table_id | view_name | view_id

Nome o ID della tabella o vista indicizzata per cui segnalare e correggere le statistiche di utilizzo dello spazio. I nomi delle tabelle e delle viste devono essere conformi alle regole per gli identificatori.

index_id | index_name

ID o nome dell'indice da utilizzare. Se viene omesso, l'istruzione elabora tutti gli indici della tabella o della vista specificata.

WITH

Consente di specificare opzioni.

NO_INFOMSGS

Disattiva tutti i messaggi informativi.

COUNT_ROWS

Specifica che la colonna row count viene aggiornata in base al numero di righe corrente della tabella o della vista.

Osservazioni

DBCC UPDATEUSAGE corregge le righe, le pagine utilizzate, le pagine riservate, le pagine foglia e i conteggi delle pagine di dati per ogni partizione in una tabella o in un indice. Se non sono presenti inesattezze nelle tabelle di sistema, DBCC UPDATEUSAGE non restituisce dati. Se vengono rilevate e corrette le inesattezze e with NO_INFOMSGS non viene utilizzato, DBCC UPDATEUSAGE restituisce le righe e le colonne da aggiornare nelle tabelle di sistema.

DBCC CHECKDB è stato migliorato per rilevare quando i conteggi delle pagine o delle righe diventano negativi. Quando viene rilevato, l'output DBCC CHECKDB contiene un avviso e una raccomandazione da eseguire DBCC UPDATEUSAGE per risolvere il problema.

Procedure consigliate

È consigliabile attenersi alle linee guida seguenti:

Non eseguire DBCC UPDATEUSAGE regolarmente, perché SQL Server gestisce i metadati nella maggior parte dei casi. DBCC UPDATEUSAGE deve essere eseguito in base alle esigenze, ad esempio quando si sospetta che i valori non corretti vengano restituiti da sp_spaceused. DBCC UPDATEUSAGEL'esecuzione di su tabelle o database di grandi dimensioni può richiedere tempi lunghi.
Prendere in considerazione l'esecuzione DBCC UPDATEUSAGE di routine (ad esempio, settimanale) solo se il database subisce frequenti modifiche DDL (Data Definition Language), ad esempio CREATE, ALTER o DROP.

Set di risultati

DBCC UPDATEUSAGE restituisce (i valori possono variare):

DBCC execution completed. If DBCC printed error messages, contact your system administrator.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin o al ruolo predefinito del database db_owner .

Esempi

R. Aggiornare i conteggi di pagine o righe o entrambi per tutti gli oggetti nel database corrente

Nell'esempio seguente viene specificato il valore 0 per il nome del database e l'istruzione DBCC UPDATEUSAGE restituisce informazioni aggiornate relative al conteggio delle pagine o delle righe per il database corrente.

DBCC UPDATEUSAGE (0);
GO

B. Aggiornare i conteggi di pagine o righe o entrambi per AdventureWorks ed eliminare i messaggi informativi

Nell'esempio seguente viene specificato AdventureWorks2022 come nome del database e vengono disattivati tutti i messaggi informativi.

DBCC UPDATEUSAGE (AdventureWorks2022) WITH NO_INFOMSGS;
GO

C. Aggiornare i conteggi di pagine o righe o entrambi per la tabella Employee

Nell'esempio seguente vengono restituite informazioni aggiornate relative al conteggio delle pagine o delle righe per la tabella Employee nel database AdventureWorks2022.

DBCC UPDATEUSAGE (AdventureWorks2022, 'HumanResources.Employee');
GO

D. Aggiornare i conteggi di pagine o righe o entrambi per un indice specifico in una tabella

Nell'esempio seguente viene specificato il valore IX_Employee_ManagerID come nome dell'indice.

DBCC UPDATEUSAGE (AdventureWorks2022, 'HumanResources.Employee', IX_Employee_OrganizationLevel_OrganizationNode);
GO

Condividi tramite