sp_helpdb (Transact-SQL)
Presenta información acerca de una base de datos especificada o de todas las bases de datos.
.gif "Icono de vínculo a temas")
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)