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


sp_helpdb (Transact-SQL)

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

Значок ссылки на разделСоглашения о синтаксисе в 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