sys.databases (Transact-SQL)sys.databases (Transact-SQL)

• 06/08/2020
• • W
  • 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のインスタンスに、データベースごとに 1 行のデータを保持します。Contains one row per database in the instance of SQL ServerSQL Server.

データベースがでない場合 ONLINE 、また AUTO_CLOSE はに設定され ON ていて、データベースが閉じている場合は、一部の列の値がになることがあり NULL ます。If a database is not ONLINE, or AUTO_CLOSE is set to ON and the database is closed, the values of some columns may be NULL. データベースがの場合 OFFLINE 、対応する行は低い特権のユーザーには表示されません。If a database is OFFLINE, the corresponding row is not visible to low-privileged users. データベースがである場合に対応する行を表示するには、少なくとも OFFLINE ALTER ANY DATABASE サーバーレベルの権限、または CREATE DATABASE データベース内の権限を持っている必要があり master ます。To see the corresponding row if the database is OFFLINE, a user must have at least the ALTER ANY DATABASE server-level permission, or the CREATE DATABASE permission in the master database.

アクセス許可Permissions

の呼び出し元 sys.databases がデータベースの所有者ではなく、データベースがまたはではない場合、 master 対応する行を tempdb 表示するために必要な最低限の権限は、 ALTER ANY DATABASE または VIEW ANY DATABASE CREATE DATABASE データベース内のサーバーレベルの権限、または権限です master 。If the caller of sys.databases is not the owner of the database and the database is not master or tempdb, the minimum permissions required to see the corresponding row are ALTER ANY DATABASE or the VIEW ANY DATABASE server-level permission, or CREATE DATABASE permission in the master database. 呼び出し元が接続されているデータベースは、常にで表示でき sys.databases ます。The database to which the caller is connected can always be viewed in sys.databases.

Azure SQL Database 解説Azure SQL Database Remarks

Azure SQL データベースAzure SQL Databaseこのビューは、 master データベースとユーザーデータベースで使用できます。In Azure SQL データベースAzure SQL Database this view is available in the master database and in user databases. データベースでは、このビューには、 master master サーバー上のデータベースとすべてのユーザーデータベースに関する情報が返されます。In the master database, this view returns the information on the master database and all user databases on the server. ユーザー データベースでは、このビューには、現在のデータベースと master データベースのみの情報が返されます。In a user database, this view returns information only on the current database and the master database.

新しいデータベースが作成される Azure SQL データベースAzure SQL Database サーバーの master データベースの sys.databases ビューを使用します。Use the sys.databases view in the master database of the Azure SQL データベースAzure SQL Database server where the new database is being created. データベースのコピーが開始されたら、コピー sys.databases 先サーバーのデータベースからおよびビューに対してクエリを実行し、 sys.dm_database_copies master コピーの進行状況に関する詳細情報を取得できます。After the database copy starts, you can query the sys.databases and the sys.dm_database_copies views from the master database of the destination server to retrieve more information about the copying progress.

例Examples

A.A. sys.databases ビューに対するクエリQuery the sys.databases view

次の例では、ビューで使用できる列のいくつかを返し sys.databases ます。The following example returns a few of the columns available in the sys.databases view.

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

B.B. SQL DatabaseSQL Database でのコピーの進行状況を確認します。Check the copying status in SQL DatabaseSQL Database

次の例では、ビューとビューに対してクエリを実行し、 sys.databases sys.dm_database_copies データベースのコピー操作に関する情報を返します。The following example queries the sys.databases and sys.dm_database_copies views to return information about a database copy operation.

適用対象: Azure SQL データベースAzure SQL DatabaseApplies to: Azure SQL データベース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.C. の一時リテンション期間ポリシーの状態を確認します。 SQL DatabaseSQL DatabaseCheck the temporal retention policy status in SQL DatabaseSQL Database

次の例では、をクエリして、 sys.databases テンポラル保持クリーンアップタスクが有効になっているかどうかの情報を返します。The following example queries the sys.databases to return information whether temporal retention cleanup task is enabled. 復元操作の後、テンポラルリテンション期間は既定で無効になっていることに注意してください。Be aware that after restore operation temporal retention is disabled by default. を使用し ALTER DATABASE て、明示的に有効にします。Use ALTER DATABASE to enable it explicitly.

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

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

次のステップNext steps

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