sp_helpdb (Transact-SQL)

適用対象: SQL サーバー

指定したデータベースまたはすべてのデータベースに関する情報を報告します。

Transact-SQL 構文表記規則

構文

sp_helpdb [ [ @dbname = ] N'dbname' ]
[ ; ]

引数

[ @dbname = ] N'dbname'

情報が報告されるデータベースの名前。 @dbnamesysname で、既定値は NULL です。 @dbnameが指定されていない場合は、sys.databases カタログ ビューのすべてのデータベースに関するレポートをsp_helpdbします。

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

列名 データ型 説明
name sysname データベース名。
db_size nvarchar(13) データベースの合計サイズ。
owner sysname saなどのデータベース所有者。
dbid smallint データベース ID。
created nvarchar(11) データベースの作成日です。
status nvarchar(600) データベースで現在設定されているデータベース オプションの値のコンマ区切りリスト。

ブール値オプションは、有効になっている場合にのみ表示されます。 ブール以外のオプションは、対応する値と共に <option_name>=<value>の形式で一覧表示されます。

詳細については、[ALTER DATABASE](/sql/t-sql/statements/alter-database-transact-sql-file-and-filegroup-options) に関する記事をご覧ください。
compatibility_level tinyint データベース 互換性レベル: 90、100、110、120、130、140、150、または 160。

@dbnameが指定されている場合、追加の結果セットには、指定したデータベースのファイル割り当てが表示されます。

列名 データ型 説明
name nchar(128) 論理ファイル名です。
fileid smallint ファイル ID。
filename nchar(260) オペレーティング システム ファイル名 (物理ファイル名)。
filegroup nvarchar(128) ファイルが属するファイル グループ。

NULL = ファイルはログ ファイルです。 ログ ファイルがファイル グループの一部になることはありません。
size nvarchar(18) ファイル サイズ (メガバイト単位)。
maxsize nvarchar(18) ファイルの最大拡張サイズです。 このフィールドの値 UNLIMITED は、ディスクがいっぱいになるまでファイルが拡張されることを示します。
growth nvarchar(18) ファイルの増加増分。 この値は、新しい領域が必要なたびにファイルに追加される領域の量を示します。
usage varchar(9) ファイルの使用方法。 データ ファイルの場合、値は data only され、ログ ファイルの値は log only

解説

結果セットの status 列は、データベースで ON に設定されているオプションを報告します。 status列によってすべてのデータベース オプションが報告されるわけではありません。 現在のデータベース オプション設定の完全な一覧を表示するには、 sys.databases カタログ ビューを使用します。

アクセス許可

1 つのデータベースを指定する場合は、データベースの public ロールのメンバーシップが必要です。 データベースが指定されていない場合は、master データベースの public ロールのメンバーシップが必要です。

データベースにアクセスできない場合、 sp_helpdb はエラー メッセージ 15622 とデータベースに関するできるだけ多くの情報を表示します。

A. 単一データベースに関する情報を返す

次の例では、AdventureWorks2022 データベースに関する情報を表示します。

EXEC sp_helpdb N'AdventureWorks2022';

B. すべてのデータベースに関する情報を返す

次の例では、SQL Server を実行しているサーバー上のすべてのデータベースに関する情報を表示します。

EXEC sp_helpdb;
GO