共用方式為


sp_helpdb (Transact-SQL)

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

適用於:SQL Server (SQL Server 2008 至目前版本)。

主題連結圖示 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

資料庫識別碼。

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)

ALTER DATABASE (Transact-SQL)

CREATE DATABASE (SQL Server Transact-SQL)

sys.databases (Transact-SQL)

sys.database_files (Transact-SQL)

sys.filegroups (Transact-SQL)

sys.master_files (Transact-SQL)

系統預存程序 (Transact-SQL)