DATABASEPROPERTYEX (Transact-SQL)

更新： 2006 年 7 月 17 日

傳回指定資料庫選項的目前設定，或指定資料庫的屬性。

Transact-SQL 語法慣例

語法

DATABASEPROPERTYEX ( database , property )

引數

• database
  這是代表傳回的具名屬性資訊所針對之資料庫名稱的運算式。 database 是 nvarchar(128)。

• property
  這是代表要傳回之資料庫屬性名稱的運算式。property 是 varchar(128)，它可以是下列值之一。傳回類型是 sql_variant。下表顯示了每一屬性值的基底資料類型。

  附註：
  如果沒有啟動資料庫，Microsoft SQL Server 2005 Database Engine 不從中繼資料而藉由直接存取資料庫，來擷取屬性會傳回 NULL。也就是說，如果資料庫的 AUTO_CLOSE 設成 ON，否則資料庫會離線。

  屬性

傳回類型

sql_variant

例外

當發生錯誤，或呼叫者沒有檢視物件的權限時，便會傳回 NULL。

在 SQL Server 2005 中，使用者只能檢視使用者擁有或被授與某些權限之安全性實體的中繼資料。這表示發出中繼資料的內建函數 (例如，OBJECT_ID) 會在使用者不具有該物件任何權限時傳回 NULL。如需詳細資訊，請參閱＜中繼資料可見性組態＞和＜中繼資料可見性疑難排解＞。

備註

DATABASEPROPERTYEX 一次只傳回一個屬性設定。若要顯示多個屬性設定，請使用 sys.databases 目錄檢視。

範例

A. 擷取 AUTO_SHRINK 資料庫選項的狀態

下列範例會傳回 AdventureWorks 資料庫 AUTO_SHRINK 資料庫選項的狀態。

SELECT DATABASEPROPERTYEX('AdventureWorks', 'IsAutoShrink');

以下為結果集： 這表示 AUTO_SHRINK 是關閉狀態。

------------------
0

B. 擷取資料庫的預設定序

下列範例會傳回 AdventureWorks 資料庫預設定序的名稱。

SELECT DATABASEPROPERTYEX('AdventureWorks', 'Collation');

以下為結果集：

------------------------------
SQL_Latin1_General_CP1_CI_AI

請參閱

參考

ALTER DATABASE (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)

其他資源

資料庫狀態
設定資料庫選項
使用 sql_variant 資料

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄

版本	歷程記錄
2006 年 7 月 17 日	新增內容： 加入「例外狀況」一節。
2006 年 4 月 14 日	變更的內容： 更正並擴充 ComparisonStyle 和 LCID 的描述。