DATABASEPROPERTYEX (Transact-SQL)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric プレビューの SQL データベース

SQL Server の指定したデータベースの場合、 DATABASEPROPERTYEX 関数は、指定したデータベース オプションまたはプロパティの現在の設定を返します。

Transact-SQL 構文表記規則

構文

DATABASEPROPERTYEX ( database , property )

引数

データベース

DATABASEPROPERTYEXが名前付きプロパティ情報を返すデータベースの名前を指定する式。 database には、データ型 nvarchar(128) が与えられます。

SQL Database については、DATABASEPROPERTYEX は現在のデータベースの名前を必要とします。 異なるデータベース名を指定すると、すべてのプロパティの NULL が返されます。

財産

返されるデータベース プロパティの名前を指定する式。 property にはデータ型 varchar(128) が与えられ、この表のいずれかの値が入ります。

戻り値の型

sql_variant

例外

エラーが発生した場合、または呼び出し元にオブジェクトを表示する権限がない場合に NULL を返します。

SQL Server では、そのユーザーが所有している、または権限を与えられている、セキュリティ保護可能なアイテムのメタデータのみを表示できます。 このルールは、ユーザーがオブジェクトに対するアクセス許可を持っていない場合、メタデータを出力する OBJECT_ID などの組み込み関数が NULL を返すことができることを意味します。 詳細については、「 メタデータの可視性の構成」を参照してください。

解説

DATABASEPROPERTYEX は、プロパティ設定を一度に 1 つだけ返します。 表示するには複数のプロパティの設定を使用して、 sys.databases カタログ ビューです。

例

この記事のコード サンプルでは、AdventureWorks2022 または AdventureWorksDW2022 サンプル データベースを使用します。このサンプル データベースは、Microsoft SQL Server サンプルとコミュニティ プロジェクト ホーム ページからダウンロードできます。

Ａ。 AUTO_SHRINK データベース オプションの状態を取得する

次の使用例は、AUTO_SHRINK データベースの AdventureWorks データベース オプションの状態を返します。

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

結果セットは次のとおりです。 これは、 AUTO_SHRINK がオフであることを示します。

0

B. データベースの既定の照合順序を取得する

この例は、AdventureWorks データベースのいくつかの属性を返します。

SELECT DATABASEPROPERTYEX('AdventureWorks2022', 'Collation') AS Collation,
       DATABASEPROPERTYEX('AdventureWorks2022', 'Edition') AS Edition,
       DATABASEPROPERTYEX('AdventureWorks2022', 'ServiceObjective') AS ServiceObjective,
       DATABASEPROPERTYEX('AdventureWorks2022', 'MaxSizeInBytes') AS MaxSizeInBytes;

結果セットは次のとおりです。

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

C: DATABASEPROPERTYEX を使用し、レプリカへの接続を検証する

Azure SQL Database スケールアウト機能を使用する場合は、データベースのコンテキストで次のクエリを実行することで、読み取り専用レプリカに接続されているかどうかを確認できます。 読み取り専用レプリカに接続すると、 READ_ONLY が返されます。 この方法により、読み取り専用レプリカでクエリが実行されているタイミングも特定できます。

SELECT DATABASEPROPERTYEX(DB_NAME(), 'Updateability');

関連コンテンツ

• データベースを変更 (Transact-SQL)
• データベースの状態
• sys.databases (Transact-SQL)
• sys.database_files (Transact-SQL)
• SERVERPROPERTY (Transact-SQL)