sys.dm_db_page_info (Transact-SQL)

Область применения: SQL Server 2019 (15.x) База данных SQL Azure Управляемый экземпляр SQL Azure

Возвращает сведения о странице в базе данных. Функция возвращает одну строку, содержащую сведения о заголовке со страницы, включая object_id, index_idи partition_id. В большинстве случаев эта функция заменяет потребность в использовании DBCC PAGE.

Синтаксис

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

Аргументы

DatabaseId | NULL | ПО УМОЛЧАНИЮ

Идентификатор базы данных. DatabaseId — smallint. Допустимые входные данные — это идентификатор базы данных. Значение по умолчанию равно NULL, однако отправка значения NULL для этого параметра приведет к ошибке.

FileId | NULL | ПО УМОЛЧАНИЮ

Идентификатор файла. FileId является int. Допустимые входные данные — это идентификатор файла в базе данных, указанной DatabaseId. Значение по умолчанию равно NULL, однако отправка значения NULL для этого параметра приведет к ошибке.

PageId | NULL | ПО УМОЛЧАНИЮ

Идентификатор страницы. PageId является int. Допустимые входные данные — это идентификатор страницы в файле, указанном FileId. Значение по умолчанию равно NULL, однако отправка значения NULL для этого параметра приведет к ошибке.

Режим | NULL | ПО УМОЛЧАНИЮ

Определяет уровень детализации выходных данных функции. 'LIMITED' возвращает значения NULL для всех столбцов описания, "DETAILED" заполняет столбцы описания. DEFAULT имеет значение 'LIMITED'.

Таблица возвращенной информации

Замечания

Функция sys.dm_db_page_info динамического управления возвращает такие сведения, как page_id, file_id, object_idindex_idи т. д., которые присутствуют в заголовке страницы. Эта информация полезна для устранения неполадок и отладки различных проблем с производительностью (блокировкой и блокировкой) и повреждениями.

sys.dm_db_page_info можно использовать вместо инструкции DBCC PAGE во многих случаях, но она возвращает только сведения о заголовке страницы, а не текст страницы. DBCC PAGE по-прежнему требуется для вариантов использования, когда требуется все содержимое страницы.

Использование в сочетании с другими динамическими представлениями

Одним из важных вариантов sys.dm_db_page_info использования является присоединение к нему с другими динамическими представлениями, предоставляющими сведения о странице. Чтобы упростить этот вариант использования, добавлен новый столбец page_resource , который предоставляет сведения о странице в шестнадцатеричном формате 8-байтов. Этот столбец добавлен sys.dm_exec_requests и sys.sysprocesses будет добавлен в другие динамические административные представления в будущем.

Новая функция sys.fn_PageResCrackerпринимает в качестве входных данных и выводит одну строку, содержащую database_idfile_id , и page_idpage_resource . Затем эту функцию можно использовать для упрощения соединений между sys.dm_exec_requests или sys.sysprocesses и sys.dm_db_page_info.

Разрешения

Требуется VIEW DATABASE STATE разрешение в базе данных.

Разрешения для SQL Server 2022 и более поздних версий

Требуется разрешение VIEW DATABASE PERFORMANCE STATE для базы данных.

Примеры

А. Отображение всех свойств страницы

Следующий запрос возвращает одну строку со всеми сведениями о странице для заданного database_id, file_idpage_id сочетания с режимом по умолчанию ('LIMITED')

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

B. Использование sys.dm_db_page_info с другими динамическими представлениями

Следующий запрос возвращает одну строку на wait_resource предоставленную sys.dm_exec_requests , если строка содержит ненулевое значение 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;

См. также

• Динамические административные представления и функции (Transact-SQL)
• Динамические административные представления базы данных (Transact-SQL)
• sys.dm_exec_requests (Transact-SQL)
• sys.fn_PageResCracker