Share via


sp_helpdb (Transact-SQL)

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

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

引数

[ @dbname = ] N'dbname'

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

リターン コードの値

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 つのデータベースを指定する場合は、データベースの パブリック ロールのメンバーシップが必要です。 データベースが指定されていない場合は、データベースの パブリック ロールの master メンバーシップが必要です。

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

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

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

EXEC sp_helpdb N'AdventureWorks2022';

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

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

EXEC sp_helpdb;
GO