sp_helpdb (Transact-SQL)

Статья
08/21/2023

Применимо к:SQL Server

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

Синтаксис

  
sp_helpdb [ [ @dbname= ] 'name' ]

Аргументы

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

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

Имя столбца	Тип данных	Описание:
name	sysname	имя базы данных.
db_size	nvarchar(13)	Общий размер базы данных.
владелец	sysname	Владелец базы данных, например sa.
dbid	smallint	Идентификатор базы данных.
created	nvarchar(11)	Дата создания базы данных.
состояние	nvarchar(600)	Разделенный запятыми список значений параметров базы данных, которые в данный момент установлены для базы данных. Перечислены только включенные параметры с логическими значениями. Параметры, не являющиеся логическими, перечислены со своими соответствующими значениями в виде значения option_name=. Дополнительные сведения см. в разделе ALTER DATABASE (Transact-SQL).
compatibility_level	tinyint	Уровень совместимости базы данных: 60, 65, 70, 80 или 90.

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

Имя столбца	Тип данных	Описание:
name	nchar(128)	Логическое имя файла.
fileid	smallint	Идентификатор файла.
filename	nchar(260)	Имя файла в операционной системе (физическое имя файла).
filegroup	nvarchar(128)	Файловая группа, к которой принадлежит файл. NULL = файл является файлом журнала. Такой файл никогда не является частью файловой группы.
size	nvarchar(18)	Размер файла в мегабайтах.
Maxsize	nvarchar(18)	Определяет максимальный размер, до которого может вырасти файл. Значение UNLIMITED в этом поле означает, что файл может расти, пока диск не будет заполнен.
Роста	nvarchar(18)	Значение прироста размера файла. Размер пространства, добавляемого в файл каждый раз, когда требуется новое пространство.
usage	varchar(9)	Применение файла. Для файла данных значение равно "только данным", а для файла журнала значение равно "только журналу".

Замечания

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

Разрешения

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

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

Примеры

О. Информация, возвращаемая о единственной базе данных

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

EXEC sp_helpdb N'AdventureWorks2022';

B. Информация, возвращаемая обо всех базах данных

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

EXEC sp_helpdb;  
GO

См. также

Хранимые процедуры ядра СУБД (Transact-SQL)
ALTER DATABASE (Transact-SQL)
CREATE DATABASE (SQL Server Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
sys.filegroups (Transact-SQL)
sys.master_files (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)