sys.dm_db_page_info (Transact-SQL)

Si applica a: SQL Server 2019 (15.x) Database SQL di Azure Istanza gestita di SQL di Azure

Restituisce informazioni su una pagina di un database. La funzione restituisce una riga che contiene le informazioni di intestazione della pagina, tra cui object_id, index_id e partition_id. Questa funzione sostituisce l'uso di DBCC PAGE nella maggior parte dei casi.

Nota

sys.dm_db_page_info è attualmente supportato solo in SQL Server 2019 (15.x) e versioni successive.

Sintassi

sys.dm_db_page_info ( DatabaseId , FileId , PageId , Mode )

Argomenti

DatabaseId | NULL | DEFAULT

ID del database. DatabaseId è smallint. L’input valido è il numero ID di un database. Il valore predefinito è NULL, ma l'invio di un valore NULL per questo parametro genererà un errore.

FileId | NULL | DEFAULT

ID del file. FileId è int. L'input valido è il numero ID di un file nel database specificato da DatabaseId. Il valore predefinito è NULL, ma l'invio di un valore NULL per questo parametro genererà un errore.

PageId | NULL | DEFAULT

L’ID della pagina. PageId è int. L'input valido è il numero ID di una pagine nel file specificato da FileId. Il valore predefinito è NULL, ma l'invio di un valore NULL per questo parametro genererà un errore.

Mode | NULL | DEFAULT

Determina il livello di dettaglio nell'output della funzione. 'LIMITED' restituirà valori NULL per tutte le colonne di descrizione, 'DETAILED' popola le colonne di descrizione. DEFAULT è .'LIMITED'

Tabella restituita

Nome colonna Tipo di dati Descrizione
database_id int ID del database.

In database SQL di Azure i valori sono univoci all'interno di un database singolo o di un pool elastico, ma non all'interno di un server logico.
file_id int ID file
page_id int ID pagina
page_header_version int Versione intestazione pagina
page_type int Tipo di pagina
page_type_desc nvarchar(64) Descrizione del tipo di pagina
page_type_flag_bits nvarchar(64) Digitare i bit flag nell'intestazione pagina
page_type_flag_bits_desc nvarchar(64) Digitare la descrizione dei bit di flag nell'intestazione pagina
page_flag_bits nvarchar(64) Bit flag nell'intestazione pagina
page_flag_bits_desc nvarchar(256) Descrizione dei bit di flag nell'intestazione della pagina
page_lsn nvarchar(64) Numero di sequenza del file di log (LSN) / data e ora
page_level int Livello della pagina nell'indice (foglia = 0)
object_id int ID dell'oggetto proprietario della pagina
index_id int ID dell'indice (0 per le pagine di dati heap)
partition_id bigint ID della partizione
alloc_unit_id bigint ID dell'unità di allocazione
is_encrypted bit Bit per indicare se la pagina è crittografata o meno
has_checksum bit Bit per indicare se la pagina ha o meno un valore di checksum
checksum int Archivia il valore di checksum usato per rilevare il danneggiamento dei dati
is_iam_pg bit Bit per indicare se la pagina è una pagina IAM o meno
is_mixed_ext bit Bit per indicare se allocato in un extent misto
has_ghost_records bit Bit per indicare se la pagina contiene record fantasma
Un record fantasma è un record contrassegnato per l'eliminazione, ma che deve ancora essere rimosso.
has_version_records bit Bit per indicare se la pagina contiene record di versione usati per il ripristino accelerato del database
pfs_page_id int ID pagina della pagina PFS corrispondente
pfs_is_allocated bit Bit per indicare se la pagina è contrassegnata come allocata nella pagina PFS corrispondente
pfs_alloc_percent int Percentuale di allocazione come indicato dal byte PFS corrispondente
pfs_status nvarchar(64) Byte PFS
pfs_status_desc nvarchar(64) Descrizione del byte PFS
gam_page_id int ID pagina della pagina GAM corrispondente
gam_status bit Bit per indicare se allocato in GAM
gam_status_desc nvarchar(64) Descrizione del bit di stato GAM
sgam_page_id int ID pagina della pagina SGAM corrispondente
sgam_status bit Bit per indicare se allocato in SGAM
sgam_status_desc nvarchar(64) Descrizione del bit di stato SGAM
diff_map_page_id int ID pagina della pagina bitmap differenziale corrispondente
diff_status bit Bit per indicare se lo stato diff viene modificato
diff_status_desc nvarchar(64) Descrizione del bit di stato diff
ml_map_page_id int ID pagina della pagina bitmap di registrazione minima corrispondente
ml_status bit Bit per indicare se la pagina è con registrazione minima
ml_status_desc nvarchar(64) Descrizione del bit di stato di registrazione minimo
prev_page_file_id smallint ID file di pagina precedente
prev_page_page_id int ID pagina precedente
next_page_file_id smallint ID file di pagina successivo
next_page_page_id int ID pagina successiva
fixed_length smallint Lunghezza delle righe a dimensione fissa
slot_count smallint Numero totale di slot (usati e inutilizzati)
Per una pagina di dati, questo numero equivale al numero di righe.
ghost_rec_count smallint Numero di record contrassegnati come fantasma nella pagina
Un record fantasma è un record contrassegnato per l'eliminazione, ma che deve ancora essere rimosso.
free_bytes smallint Numero di byte liberi nella pagina
free_data_offset int Scarto dello spazio disponibile alla fine dell'area dati
reserved_bytes smallint Numero di byte liberi riservati da tutte le transazioni (se heap)
Numero di righe fantasma (se foglia indice)
reserved_bytes_by_xdes_id smallint Spazio contribuito da m_xdesID a m_reservedCnt
Solo per fini di debug
xdes_id nvarchar(64) Ultima transazione contribuita da m_reserved
Solo per fini di debug

Osservazioni:

La funzione a gestione dinamica sys.dm_db_page_info restituisce informazioni quali page_id, file_id, index_id, object_id e così via, presenti in un'intestazione pagina. Queste informazioni sono utili per la risoluzione dei problemi e il debug di vari problemi di prestazioni (contesa di blocchi e latch) e danneggiamento.

sys.dm_db_page_info può essere usato al posto dell'istruzione DBCC PAGE in molti casi, ma restituisce solo le informazioni sull'intestazione della pagina, non il corpo della pagina. DBCC PAGE sarà comunque necessario per i casi d'uso in cui è necessario l'intero contenuto della pagina.

Usare insieme ad altri DMV

Uno dei casi d'uso importanti di sys.dm_db_page_info consiste nell'aggiungerlo ad altri DMV che espongono informazioni sulla pagina. Per facilitare questo caso d'uso, è stata aggiunta una nuova colonna denominata page_resource che espone le informazioni sulla pagina in un formato esadecimale a 8 byte. Questa colonna è stata aggiunta a sys.dm_exec_requests e sys.sysprocesses verrà aggiunta ad altre DMV in futuro in base alle esigenze.

Una nuova funzione, sys.fn_PageResCracker, accetta page_resource come input e restituisce una singola riga contenente database_id, file_id e page_id. Questa funzione può quindi essere usata per facilitare l’unione tra sys.dm_exec_requests o sys.sysprocesses e sys.dm_db_page_info.

Autorizzazioni

In VIEW DATABASE STATE è richiesta l'autorizzazione per il database.

Autorizzazioni per SQL Server 2022 e versioni successive

È richiesta l'autorizzazione VIEW DATABASE PERFORMANCE STATE per il database.

Esempi

R. Visualizzare le proprietà di una pagina

La query seguente restituisce una riga con tutte le informazioni sulla pagina per una determinata combinazione di database_id, file_id, page_id con la modalità predefinita ('LIMITED')

SELECT *
FROM sys.dm_db_page_info (5, 1, 15, DEFAULT);

B. Usare sys.dm_db_page_info con altri DMV

La query seguente restituisce una riga per ogni wait_resource riga esposta da sys.dm_exec_requests quando la riga contiene un valore non Null page_resource

SELECT page_info.*
FROM sys.dm_exec_requests AS d
CROSS APPLY sys.fn_PageResCracker(d.page_resource) AS r
CROSS APPLY sys.dm_db_page_info(r.db_id, r.file_id, r.page_id, 'LIMITED') AS page_info;

Vedi anche