sys.databases (Transact-SQL)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウスMicrosoft Fabric プレビューの SQL データベース

SQL Serverのインスタンスに、データベースごとに 1 行のデータを保持します。

データベースが ONLINEされていない場合、または AUTO_CLOSE が ON に設定されていて、データベースが閉じている場合は、一部の列の値を NULLできます。 データベースが OFFLINE である場合、対応する行は、権限の低いユーザーに対して表示されません。 データベースが OFFLINE である場合、対応する行を表示するには、ユーザーが少なくともサーバー レベルの ALTER ANY DATABASE アクセス許可、または CREATE DATABASE データベースの master アクセス許可を持っている必要があります。

¹ 互換性レベルの完全な一覧については、ALTER DATABASE 互換性レベルを参照してください。

Permissions

sys.databases の呼び出し元がデータベースの所有者ではなく、データベースが master でも tempdb でもない場合、対応する行を表示するには、ALTER ANY DATABASE データベースで、VIEW ANY DATABASE または CREATE DATABASE のサーバーレベルのアクセス許可、あるいは、master のアクセス許可が最小限必要です。 呼び出し元が接続しているデータベースは常に sys.databases で確認できます。

Remarks

Azure SQL Database では、master データベースとユーザー データベースでこのビューを使用できます。 master データベースでは、master データベースとサーバー上のすべてのユーザー データベースに関する情報がこのビューに返されます。 ユーザー データベースでは、このビューは現在のデータベースと master データベースに関する情報のみを返します。

メタデータ同期の可能性があるため、 sys.databases ビューでは、データベースの暗号化に関する正しくない情報が提供される可能性があります。 正確な結果を得るには、 sys.dm_database_encryption_keys ビューを使用して実際の暗号化状態を取得することをお勧めします。

新しいデータベースが作成される Azure SQL Database サーバー サーバーの sys.databases データベースの master ビューを使用します。 データベースのコピーが開始された後で、コピー先サーバーの sys.databases データベースから sys.dm_database_copies と master のビューに対してクエリを実行して、コピーの進行状況に関する詳細を取得できます。

Examples

A. sys.databases ビューに対してクエリを実行する

次の例では、sys.databases ビューで使用できる列をいくつか返します。

SELECT name,
       user_access_desc,
       is_read_only,
       state_desc,
       recovery_model_desc
FROM sys.databases;

B. Azure SQL Database でコピーの状態を確認する

次の例では、sys.databases ビューと sys.dm_database_copies ビューに対してクエリを実行し、データベースのコピー操作に関する情報を返します。

適用対象: Azure SQL Database

-- Execute from the master database.
SELECT a.name,
       a.state_desc,
       b.start_date,
       b.modify_date,
       b.percent_complete
FROM sys.databases AS a
     INNER JOIN sys.dm_database_copies AS b
         ON a.database_id = b.database_id
WHERE a.state = 7;

C. SQL Database でテンポラル保持ポリシーの状態を確認する

次の例では、sys.databases ビューに対してクエリを実行し、テンポラ保持のクリーンアップ タスクが有効かどうかに関する情報を返します。 既定では、復元操作後のテンポラル保持は無効になっています。 これを明示的に有効にするには、ALTER DATABASE を使用します。

適用対象: Azure SQL Database

-- Execute from the master database.
SELECT a.name,
       a.is_temporal_history_retention_enabled
FROM sys.databases AS a;

Related content

• データベースを変更 (Transact-SQL)
• ALTER DATABASE (Transact-SQL) 互換性レベル
• sys.database_mirroring_witnesses (Transact-SQL)
• sys.database_recovery_status (Transact-SQL)
• データベースとファイルのカタログ ビュー (Transact-SQL)
• sys.dm_database_copies (Azure SQL データベース)