sp_helpdb (Transact-SQL)
適用対象: 
SQL サーバー
指定したデータベースまたはすべてのデータベースに関する情報を報告します。
構文
sp_helpdb [ [ @dbname = ] N'dbname' ]
[ ; ]
引数
[ @dbname = ] N'dbname'
情報が報告されるデータベースの名前。 @dbname は sysname で、既定値は 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>の形式で一覧表示されます。詳細については、 |
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