sp_helpdb (Transact-SQL)
報告指定的資料庫或所有資料庫的相關資訊。
適用於:SQL Server (SQL Server 2008 至目前版本)。 |
語法
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 |
資料庫識別碼。 |
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 |
檔案識別碼。 |
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.傳回單一資料庫的相關資訊
下列範例會顯示 AdventureWorks2012 資料庫的相關資訊。
EXEC sp_helpdb N'AdventureWorks2012';
B.傳回所有資料庫的相關資訊
下列範例會顯示執行 SQL Server 的伺服器之所有資料庫的相關資訊。
EXEC sp_helpdb;
GO
請參閱
參考
Database Engine 預存程序 (Transact-SQL)
CREATE DATABASE (SQL Server Transact-SQL)
sys.database_files (Transact-SQL)