Поделиться через


sp_helpdb (Transact-SQL)

Область применения: SQL Server

Сообщает информацию об указанной базе данных или всех базах данных.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_helpdb [ [ @dbname = ] N'dbname' ]
[ ; ]

Аргументы

[ @dbname = ] N'dbname'

Имя базы данных, для которой сообщается информация. @dbname — sysname с значением по умолчаниюNULL. Если @dbname не указан, sp_helpdb отчеты обо всех базах данных в представлении sys.databases каталога.

Значения кода возврата

0 (успешно) или 1 (сбой).

Результирующий набор

Имя столбца Тип данных Description
name sysname имя базы данных.
db_size nvarchar(13) Общий размер базы данных.
owner sysname Владелец базы данных, например sa.
dbid smallint Идентификатор базы данных.
created nvarchar(11) Дата создания базы данных.
status nvarchar(600) Разделенный запятыми список значений параметров базы данных, которые в данный момент установлены для базы данных.

Логические параметры отображаются только в том случае, если они включены. Параметры, отличные от boolean, перечислены со своими соответствующими значениями в виде <option_name>=<value>.

Дополнительные сведения см. в статье Параметры инструкции ALTER DATABASE для файлов и файловых групп (Transact-SQL).
compatibility_level tinyint Уровень совместимости базы данных: 90, 100, 110, 120, 130, 140, 150 или 160.

Если указан @dbname , дополнительный результирующий набор отображает выделение файла для указанной базы данных.

Имя столбца Тип данных Description
name nchar(128) Логическое имя файла.
fileid smallint Идентификатор файла.
filename nchar(260) Имя файла в операционной системе (физическое имя файла).
filegroup nvarchar(128) Файловая группа, к которой принадлежит файл.

NULL = файл журнала. Файлы журналов никогда не являются частью файловой группы.
size nvarchar(18) Размер файла в мегабайтах.
maxsize nvarchar(18) Определяет максимальный размер, до которого может вырасти файл. Значение UNLIMITED в этом поле указывает, что файл растет до тех пор, пока диск не будет заполнен.
growth nvarchar(18) Значение прироста размера файла. Это значение указывает объем пространства, добавленного в файл каждый раз, когда требуется новое пространство.
usage varchar(9) Применение файла. Для файла данных значение равно data only и для файла log onlyжурнала.

Замечания

Столбец status в результирующем наборе сообщает, какие параметры заданы ON в базе данных. Не все параметры базы данных сообщаются столбцом status . Чтобы просмотреть полный список параметров текущей базы данных, используйте sys.databases представление каталога.

Разрешения

При указании одной базы данных требуется членство в общедоступной роли в базе данных. Если база данных не указана, требуется членство в общедоступной роли в master базе данных.

Если к базе данных не удается получить доступ, sp_helpdb отображается сообщение об ошибке 15622 и столько сведений о базе данных, сколько это возможно.

Примеры

А. Возврат сведений об одной базе данных

В следующем примере отображается информация о базе данных AdventureWorks2022.

EXEC sp_helpdb N'AdventureWorks2022';

B. Возврат сведений обо всех базах данных

В следующем примере отображаются сведения обо всех базах данных на сервере под управлением SQL Server.

EXEC sp_helpdb;
GO