sp_helpdb (Transact-SQL)

Presenta información acerca de una base de datos especificada o de todas las bases de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_helpdb [ [ @dbname= ] 'name' ]

Argumentos

• [ @dbname=] 'name'
  Es el nombre de la base de datos para la que se presenta información. name es de tipo sysname y no tiene ningún valor predeterminado. Si no se especifica name, sp_helpdb presenta información sobre todas las bases de datos de la vista de catálogo sys.databases.

Conjuntos de resultados

Nombre de columna	Tipo de datos	Descripción
name	sysname	Nombre de la base de datos.
db_size	nvarchar(13)	Tamaño total de la base de datos.
owner	sysname	Propietario de la base de datos; por ejemplo, sa.
dbid	smallint	Id. de la base de datos.
created	nvarchar(11)	Fecha de creación de la base de datos.
status	nvarchar(600)	Lista de valores separados por comas de las opciones actualmente establecidas en la base de datos. Las opciones con valores booleanos aparecen solamente si están habilitadas. Las opciones no booleanas se muestran con sus valores correspondientes, con el formato option_name=value. Para obtener más información, vea ALTER DATABASE (Transact-SQL).
compatibility_level	tinyint	Nivel de compatibilidad de la base de datos: 60, 65, 70, 80 o 90.

Si se especifica name, hay un conjunto de resultados adicional que muestra la asignación de archivos de la base de datos especificada.

Nombre de columna	Tipo de datos	Descripción
name	nchar(128)	Nombre de archivo lógico.
fileid	smallint	Id. de archivo.
filename	nchar(260)	Nombre del archivo en el sistema operativo (nombre de archivo físico).
filegroup	nvarchar(128)	Grupo al que pertenece el archivo. NULL = El archivo es de registro. Nunca forma parte de un grupo de archivos.
size	nvarchar(18)	Tamaño del archivo, en megabytes.
maxsize	nvarchar(18)	Tamaño máximo que puede alcanzar el archivo. El valor UNLIMITED en este campo indica que el archivo puede aumentar hasta que el disco esté lleno.
growth	nvarchar(18)	Incremento de crecimiento del archivo. Indica la cantidad de espacio que se agrega al archivo cada vez que se necesita espacio.
usage	varchar(9)	Uso del archivo. Para un archivo de datos, el valor es 'data only' y para el archivo de registro es valor es 'log only'.

Notas

La columna status del conjunto de resultados indica qué opciones se han establecido en ON en la base de datos. La columna status no presenta información acerca de todas las opciones de la base de datos. Para obtener una lista completa de las opciones actualmente configuradas para la base de datos, utilice la vista de catálogo sys.databases.

Permisos

Cuando se especifica una sola base de datos, se debe pertenecer a la función public en la base de datos. Cuando no se especifica ninguna base de datos, se debe pertenecer a la función public en la base de datos master.

Si no se puede tener acceso a una base de datos, sp_helpdb presenta el mensaje de error 15622 y toda la información que puede proporcionar acerca de la base de datos.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

A. Devolver información acerca de una sola base de datos

En el siguiente ejemplo se muestra información sobre la base de datos AdventureWorks.

EXEC sp_helpdb N'AdventureWorks';

B. Devolver información acerca de todas las bases de datos

En el ejemplo siguiente se muestra información acerca de todas las bases de datos del servidor donde se ejecuta SQL Server.

EXEC sp_helpdb;
GO

Vea también

Referencia

Procedimientos almacenados del motor de base de datos (Transact-SQL)
ALTER DATABASE (Transact-SQL)
CREATE DATABASE (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
sys.filegroups (Transact-SQL)
sys.master_files (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005