sp_helpdb (Transact-SQL)

Se aplica a:SQL Server

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 notifica información. name es sysname, sin valor predeterminado. Si no se especifica el nombre , sp_helpdb notifica todas las bases de datos de la vista de catálogo sys.databases .

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de la columna	Tipo de datos	Descripción
name	sysname	nombre de base de datos.
db_size	nvarchar(13)	Tamaño total de la base de datos.
owner	sysname	Propietario de la base de datos, como 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 que no son booleanas se muestran con sus valores correspondientes en forma de valor option_name=. Para obtener más información, consulte 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 para la base de datos especificada.

Nombre de la columna	Tipo de datos	Descripción
name	nchar(128)	Nombre de archivo lógico.
fileid	smallint	Identificador de archivo.
filename	nchar(260)	Nombre del archivo en el sistema operativo (nombre de archivo físico).
grupo_de_archivos	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. Esto indica la cantidad de espacio agregado al archivo cada vez que se necesita espacio nuevo.
Uso	varchar(9)	Uso del archivo. Para un archivo de datos, el valor es "solo datos" y para el archivo de registro, el valor es "solo registro".

Comentarios

La columna status del conjunto de resultados informa de qué opciones se han establecido en ON en la base de datos. La columna de estado no notifica todas las opciones de base de datos. Para ver una lista completa de la configuración de la opción de base de datos actual, use la vista de catálogo sys.databases .

Permisos

Cuando se especifica una base de datos única, se requiere la pertenencia al rol público de la base de datos. Cuando no se especifica ninguna base de datos, se requiere la pertenencia al rol público en la base de datos maestra .

Si no se puede acceder a una base de datos, sp_helpdb muestra el mensaje de error 15622 y tanta información sobre la base de datos como pueda.

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 AdventureWorks2022.

EXEC sp_helpdb N'AdventureWorks2022';  

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

En este ejemplo siguiente se muestra información sobre todas las bases de datos del servidor que ejecuta SQL Server.

EXEC sp_helpdb;  
GO  

Consulte también

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