sys.databases (Transact-SQL)

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric の SQL 分析エンドポイント Microsoft Fabric のウェアハウス

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

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

アクセス許可

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

解説

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

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

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

例

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

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

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

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

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

適用対象: Azure SQL データベース

-- 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 データベース

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

関連するコンテンツ

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