sp_helpdb (Transact-SQL)
Сообщает информацию об указанной базе данных или всех базах данных.
.gif "Значок ссылки на раздел")
Соглашения о синтаксисе в Transact-SQL
Синтаксис
sp_helpdb [ [ @dbname= ] 'name' ]
Аргументы
- [ @dbname= ] 'name'
Имя базы данных, для которой сообщается информация. Аргумент name имеет тип sysname и не имеет значения по умолчанию. Если аргумент name не указан, процедура sp_helpdb сообщает обо всех базах данных в представлении каталога sys.databases.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Результирующие наборы
| Имя столбца | Тип данных | Описание |
|---|---|---|
name |
sysname |
Имя базы данных. |
db_size |
nvarchar(13) |
Общий размер базы данных. |
owner |
sysname |
Владелец базы данных, например sa. |
dbid |
smallint |
Идентификатор базы данных. |
created |
nvarchar(11) |
Дата создания базы данных. |
status |
nvarchar(600) |
Разделенный запятыми список значений параметров базы данных, которые в данный момент установлены для базы данных. Перечислены только включенные параметры с логическими значениями. Параметры, не являющиеся логическими, приведены вместе с соответствующими значениями в форме option_name=value. Дополнительные сведения см. в разделе ALTER DATABASE (Transact-SQL). |
compatibility_level |
tinyint |
Уровень совместимости базы данных: 60, 65, 70, 80 или 90. |
Если параметр name указан, существует дополнительный результирующий набор, который показывает распределение файлов для указанной базы данных.
| Имя столбца | Тип данных | Описание |
|---|---|---|
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.
Разрешения
Если указана единственная база данных, то обязательно членство в роли public в базе данных. Если не указано ни одной базы данных, то обязательно членство в роли public в базе данных master.
Если база данных недоступна, процедура sp_helpdb выводит сообщение об ошибке номер 15622 и всю имеющуюся информацию о базе данных.
Примеры
А. Информация, возвращаемая о единственной базе данных
В следующем примере отображается информация о базе данных AdventureWorks.
EXEC sp_helpdb N'AdventureWorks';
Б. Информация, возвращаемая обо всех базах данных
В следующем примере отображается информация обо всех базах данных, работающих на сервере SQL Server.
EXEC sp_helpdb;
GO
См. также
Справочник
Хранимые процедуры ядра СУБД (Transact-SQL)
ALTER DATABASE (Transact-SQL)
CREATE DATABASE (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
sys.filegroups (Transact-SQL)
sys.master_files (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)