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

数据库 ID。

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

文件 ID。

filename

nchar(260)

操作系统文件名(物理文件名称)。

filegroup

nvarchar(128)

文件所属的文件组。

NULL = 文件为日志文件。它决不是文件组的一部分。

size

nvarchar(18)

文件大小 (MB)。

maxsize

nvarchar(18)

文件大小可达到的最大值。此字段中的 UNLIMITED 值表示文件可以一直增长到磁盘变满为止。

growth

nvarchar(18)

文件的增量。表示每次需要新的空间时给文件增加的空间大小。

usage

varchar(9)

文件用法。对于数据文件,该值为 'data only',对于日志文件,该值为 'log only'。

注释

结果集中的 status 列报告数据库中已设置为 ON 的选项。并非所有的数据库选项都由 status 列报告。若要查看当前数据库选项设置的完整列表,请使用 sys.databases 目录视图。

权限

当指定单个数据库时,需要具有数据库中的 public 角色成员身份。当没有指定数据库时,需要具有 master 数据库中的 public 角色成员身份。

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

示例

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

以下示例显示有关 AdventureWorks 数据库的信息。

EXEC sp_helpdb N'AdventureWorks';

B. 返回有关所有数据库的信息

以下示例显示有关运行 SQL Server 的服务器上所有数据库的信息。

EXEC sp_helpdb;
GO