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