DATABASEPROPERTYEX (Transact-SQL)DATABASEPROPERTYEX (Transact-SQL)

• 04/23/2018
• • c
  • o
  • y
  • O

適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse

SQL ServerSQL Server の指定データベースについては、指定のデータベース オプションまたはプロパティの現在の設定がこの関数によって返されます。For a specified database in SQL ServerSQL Server, this function returns the current setting of the specified database option or property.

Transact-SQL 構文表記規則 Transact-SQL Syntax Conventions

構文Syntax

DATABASEPROPERTYEX ( database , property )  

引数Arguments

databasedatabase
データベースの名前を指定する式。このデータベースに対して、DATABASEPROPERTYEX は指定されたプロパティ情報を返します。An expression specifying the name of the database for which DATABASEPROPERTYEX will return the named property information. database には、データ型 nvarchar(128) が与えられます。database has an nvarchar(128) data type.

SQL DatabaseSQL Database については、DATABASEPROPERTYEX は現在のデータベースの名前を必要とします。For SQL DatabaseSQL Database, DATABASEPROPERTYEX requires the name of the current database. 別のデータベース名が指定されている場合、すべてのプロパティに対して NULL を返します。It returns NULL for all properties if given a different database name.

propertyproperty
返されるデータベース プロパティの名前を指定する式。An expression specifying the name of the database property to return. property にはデータ型 varchar(128) が与えられ、この表のいずれかの値が入ります。property has a varchar(128) data type, and supports one of the values in this table:

戻り値の型Return types

sql_variantsql_variant

例外Exceptions

エラーが発生した場合、または呼び出し元にオブジェクトの表示権限がない場合は、NULL が返されます。Returns NULL on error, or if a caller does not have permission to view the object.

SQL ServerSQL Server では、そのユーザーが所有している、または権限を与えられている、セキュリティ保護可能なアイテムのメタデータのみを表示できます。In SQL ServerSQL Server, a user can only view the metadata of securables that the user owns or on which the user has been granted permission. つまり、オブジェクトに対する権限がユーザーに与えられていない場合、OBJECT_ID のような、メタデータを生成する組み込み関数によって NULL が返されることがあります。This means that metadata-emitting, built-in functions such as OBJECT_ID may return NULL if the user has no permissions on the object. 詳細については、「メタデータ表示の構成」を参照してください。See Metadata Visibility Configuration for more information.

解説Remarks

DATABASEPROPERTYEX は、プロパティ設定を一度に 1 つだけ返します。DATABASEPROPERTYEX returns only one property setting at a time. 表示するには複数のプロパティの設定を使用して、 sys.databases カタログ ビューです。To display multiple property settings, use the sys.databases catalog view.

例Examples

A.A. AUTO_SHRINK データベース オプションの設定値を取得するRetrieving the status of the AUTO_SHRINK database option

この例では、AdventureWorks データベースの AUTO_SHRINK データベース オプションのステータスを返します。This example returns the status of the AUTO_SHRINK database option for the AdventureWorks database.

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

結果セットは次のようになります。Here is the result set.この結果セットは、AUTO_SHRINK がオフであることを示しています。This indicates that AUTO_SHRINK is off.

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

B.B. データベースの既定の照合順序を取得するRetrieving the default collation for a database

この例は、AdventureWorks データベースのいくつかの属性を返します。This example returns several attributes of the AdventureWorks database.

SELECT   
    DATABASEPROPERTYEX('AdventureWorks2014', 'Collation') AS Collation,  
    DATABASEPROPERTYEX('AdventureWorks2014', 'Edition') AS Edition,  
    DATABASEPROPERTYEX('AdventureWorks2014', 'ServiceObjective') AS ServiceObjective,  
    DATABASEPROPERTYEX('AdventureWorks2014', 'MaxSizeInBytes') AS MaxSizeInBytes  

結果セットは次のようになります。Here is the result set.

Collation                     Edition        ServiceObjective  MaxSizeInBytes  
----------------------------  -------------  ----------------  --------------  
SQL_Latin1_General_CP1_CI_AS  DataWarehouse  DW1000            5368709120  

関連項目See also

ALTER DATABASE (Transact-SQL)ALTER DATABASE (Transact-SQL)
データベースの状態Database States
sys.databases (Transact-SQL)sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)sys.database_files (Transact-SQL)
SERVERPROPERTY (Transact-SQL)SERVERPROPERTY (Transact-SQL)