sp_helpdb (Transact-SQL)

适用于:SQL Server

报告有关指定数据库或所有数据库的信息。

Transact-SQL 语法约定

语法

  
sp_helpdb [ [ @dbname= ] 'name' ]  

参数

[ @dbname = ] 'name' 为其报告信息的数据库的名称。 namesysname,没有默认值。 如果未指定 namesp_helpdbsys.databases 目录视图中所有数据库的报表。

返回代码值

0(成功)或 1(失败)

结果集

列名称 数据类型 说明
name sysname 数据库名称。
db_size nvarchar (13) 数据库总计大小。
所有者 sysname 数据库所有者,例如 sa
dbid smallint 数据库 ID。
created nvarchar(11) 数据库创建的日期。
status nvarchar (600) 以逗号分隔的值列表,这些值是当前在数据库上设置的数据库选项的值。

只有启用布尔值选项时,才将这些选项列出。 非布尔选项以option_name=值的形式与其对应的一起列出。

有关详细信息,请参阅 ALTER DATABASE (Transact-SQL)
compatibility_level tinyint 数据库兼容级别:60、65、70、80 或 90。

如果指定 了 name ,则还有一个显示指定数据库的文件分配的其他结果集。

列名称 数据类型 说明
name nchar(128) 逻辑文件名。
fileid smallint 文件 ID。
filename nchar (260) 操作系统文件名(物理文件名称)。
filegroup nvarchar(128) 文件所属的文件组。

NULL = 文件为日志文件。 它决不是文件组的一部分。
大小 nvarchar (18) 文件大小 (MB)。
maxsize nvarchar (18) 文件大小可达到的最大值。 此字段中的 UNLIMITED 值表示文件可以一直增长到磁盘变满为止。
growth nvarchar (18) 文件的增量。 这表示每次需要新空间时添加到文件的空间量。
usage varchar (9) 文件用法。 对于数据文件,值为“仅限数据”,对于日志文件,该值为“仅日志”。

注解

结果集中 的状态 列报告数据库中哪些选项已设置为 ON。 状态列不会报告所有数据库选项。 若要查看当前数据库选项设置的完整列表,请使用 sys.databases 目录视图。

权限

指定单个数据库时,需要数据库中 公共 角色的成员身份。 如果未指定任何数据库,则需要 master 数据库中公共角色的成员身份。

如果无法访问数据库, sp_helpdb 将显示错误消息 15622,并尽可能多地显示有关数据库的信息。

示例

A. 返回有关单个数据库的信息

以下示例显示有关 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)