sp_helpdb (Transact-SQL)

適用於:SQL Server

報告指定資料庫或所有資料庫的相關信息。

Transact-SQL 語法慣例

語法

sp_helpdb [ [ @dbname = ] N'dbname' ]
[ ; ]

引數

[ @dbname = ] N'dbname'

報告資訊的資料庫名稱。 @dbname為 sysname,預設值為 NULL。 如果未 指定@dbnamesp_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
compatibility_level tinyint 資料庫 相容性層級:90、100、110、120、130、140、150 或 160。

如果 指定了@dbname ,額外的結果集會顯示指定資料庫的檔案配置。

資料行名稱 資料類型 描述
name nchar(128) 邏輯檔名。
fileid smallint 檔案標識碼。
filename nchar(260) 操作系統檔名(實體檔名)。
filegroup nvarchar(128) 檔案所屬的檔案群組。

NULL = file 是記錄檔。 記錄檔絕不是檔案群組的一部分。
size nvarchar(18) 以 MB 為單位的檔案大小。
maxsize nvarchar(18) 檔案可成長的大小上限。 此欄位中的 值 UNLIMITED 表示檔案會成長到磁碟已滿為止。
growth nvarchar(18) 檔案的成長增量。 這個值表示每次需要新空間時,新增至檔案的空間量。
usage varchar(9) 檔案的使用方式。 對於資料檔,值是 data only ,而記錄檔的值是 log only

備註

status結果集中的數據行會報告資料庫中要設定ON的選項。 並非所有資料庫選項都會由 status 數據行報告。 若要查看目前資料庫選項設定的完整清單,請使用 sys.databases 目錄檢視。

權限

指定單一資料庫時,需要資料庫中公用角色的成員資格。 若未指定資料庫,則需要資料庫中公用角色的成員master資格。

如果無法存取資料庫, sp_helpdb 則會顯示錯誤訊息 15622,以及資料庫的詳細資訊。

範例

A. 傳回單一資料庫的相關信息

下列範例會顯示資料庫的相關信息 AdventureWorks2022

EXEC sp_helpdb N'AdventureWorks2022';

B. 傳回所有資料庫的相關信息

下列範例會顯示執行 SQL Server 之伺服器上所有資料庫的相關信息。

EXEC sp_helpdb;
GO