sp_helpdb (Transact-SQL)
適用於：
SQL Server
報告指定資料庫或所有資料庫的相關信息。
語法
sp_helpdb [ [ @dbname = ] N'dbname' ]
[ ; ]
引數
[ @dbname = ] N'dbname'
報告資訊的資料庫名稱。 @dbname為 sysname，預設值為 NULL。 如果未 指定@dbname ， sp_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