sp_helpdb (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