| title | sp_helpdb (Transact-SQL) | Microsoft Docs | ||
|---|---|---|---|
| ms.custom | |||
| ms.date | 03/14/2017 | ||
| ms.prod | sql | ||
| ms.prod_service | database-engine | ||
| ms.service | |||
| ms.component | system-stored-procedures | ||
| ms.reviewer | |||
| ms.suite | sql | ||
| ms.technology |
|
||
| ms.tgt_pltfrm | |||
| ms.topic | language-reference | ||
| f1_keywords |
|
||
| dev_langs |
|
||
| helpviewer_keywords |
|
||
| ms.assetid | 4c3e3302-6cf1-4b2b-8682-004049b578c3 | ||
| caps.latest.revision | 37 | ||
| author | edmacauley | ||
| ms.author | edmaca | ||
| manager | craigg | ||
| ms.workload | On Demand |
[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]
Reports information about a specified database or all databases.
Transact-SQL Syntax Conventions
sp_helpdb [ [ @dbname= ] 'name' ]
[ @dbname= ] 'name'
Is the name of the database for which information is reported. name is sysname, with no default. If name is not specified, sp_helpdb reports on all databases in the sys.databases catalog view.
0 (success) or 1 (failure)
| Column name | Data type | Description |
|---|---|---|
| name | sysname | Database name. |
| db_size | nvarchar(13) | Total size of the database. |
| owner | sysname | Database owner, such as sa. |
| dbid | smallint | Database ID. |
| created | nvarchar(11) | Date the database was created. |
| status | nvarchar(600) | Comma-separated list of values of database options that are currently set on the database. Boolean-valued options are listed only if they are enabled. Non-Boolean options are listed with their corresponding values in the form of option_name=value. For more information, see ALTER DATABASE (Transact-SQL). |
| compatibility_level | tinyint | Database compatibility level: 60, 65, 70, 80, or 90. |
If name is specified, there is an additional result set that shows the file allocation for the specified database.
| Column name | Data type | Description |
|---|---|---|
| name | nchar(128) | Logical file name. |
| fileid | smallint | File ID. |
| filename | nchar(260) | Operating-system file name (physical file name). |
| filegroup | nvarchar(128) | Filegroup in which the file belongs. NULL = file is a log file. This is never a part of a filegroup. |
| size | nvarchar(18) | File size in megabytes. |
| maxsize | nvarchar(18) | Maximum size to which the file can grow. A value of UNLIMITED in this field indicates that the file grows until the disk is full. |
| growth | nvarchar(18) | Growth increment of the file. This indicates the amount of space added to the file each time new space is needed. |
| usage | varchar(9) | Usage of the file. For a data file, the value is 'data only' and for the log file the value is 'log only'. |
The status column in the result set reports which options have been set to ON in the database. All database options are not reported by the status column. To see a complete list of the current database option settings, use the sys.databases catalog view.
When a single database is specified, membership in the public role in the database is required. When no database is specified, membership in the public role in the master database is required.
If a database cannot be accessed, sp_helpdb displays error message 15622 and as much information about the database as it can.
The following example displays information about the [!INCLUDEssSampleDBobject] database.
EXEC sp_helpdb N'AdventureWorks2012'; This following example displays information about all databases on the server running [!INCLUDEssNoVersion].
EXEC sp_helpdb;
GO Database Engine Stored Procedures (Transact-SQL)
ALTER DATABASE (Transact-SQL)
CREATE DATABASE (SQL Server Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
sys.filegroups (Transact-SQL)
sys.master_files (Transact-SQL)
System Stored Procedures (Transact-SQL)