sp_helpdb (Transact-SQL)

S'applique à : SQL Server

Affiche des informations sur une base de données précise ou sur toutes les bases de données.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @dbname = ] N’dbname'

Nom de la base de données pour laquelle des informations sont signalées. @dbname est sysname, avec la valeur par défaut NULL. Si @dbname n’est pas spécifié, sp_helpdb les rapports sur toutes les bases de données de l’affichage sys.databases catalogue.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Nom de la colonne Type de données Description
name sysname Nom de la base de données.
db_size nvarchar(13) Taille totale de la base de données.
owner sysname Propriétaire de la base de données, tel que sa.
dbid smallint ID de la base de données.
created nvarchar(11) Date de création de la base de données.
status nvarchar(600) Liste de valeurs, séparées par des virgules, d'options de base de données actuellement définies pour la base de données.

Les options booléennes sont répertoriées uniquement si elles sont activées. Les options non booléennes sont répertoriées avec leurs valeurs correspondantes sous la forme .<option_name>=<value>

Pour en savoir plus, consultez ALTER DATABASE.
compatibility_level tinyint Niveau de compatibilité de la base de données : 90, 100, 110, 120, 130, 140, 150 ou 160.

Si @dbname est spécifié, un jeu de résultats supplémentaire affiche l’allocation de fichiers pour la base de données spécifiée.

Nom de la colonne Type de données Description
name nchar(128) Nom de fichier logique.
fileid smallint ID de fichier.
filename nchar(260) Nom de fichier du système d'exploitation (nom de fichier physique).
filegroup nvarchar(128) Groupe de fichiers auquel le fichier appartient.

NULL = fichier est un fichier journal. Les fichiers journaux ne font jamais partie d’un groupe de fichiers.
size nvarchar(18) Taille du fichier exprimée en mégaoctets.
maxsize nvarchar(18) Taille maximale du fichier. Une valeur de UNLIMITED ce champ indique que le fichier augmente jusqu’à ce que le disque soit plein.
growth nvarchar(18) Incrément de croissance du fichier. Cette valeur indique la quantité d’espace ajoutée au fichier chaque fois que de nouveaux espaces sont nécessaires.
usage varchar(9) Utilisation du fichier. Pour un fichier de données, la valeur est data only et pour le fichier journal, la valeur est log only.

Notes

La status colonne du jeu de résultats signale les options définies ON dans la base de données. Toutes les options de base de données ne sont pas signalées par la status colonne. Pour afficher la liste complète des paramètres d’option de base de données actuels, utilisez l’affichage sys.databases catalogue.

autorisations

Lorsqu’une base de données unique est spécifiée, l’appartenance au rôle public dans la base de données est requise. Quand aucune base de données n’est spécifiée, l’appartenance au rôle public dans la master base de données est requise.

Si une base de données n’est pas accessible, sp_helpdb affiche le message d’erreur 15622 et autant d’informations sur la base de données que possible.

Exemples

R. Retourner des informations sur une base de données unique

Cet exemple affiche des informations sur la base de données AdventureWorks2022.

EXEC sp_helpdb N'AdventureWorks2022';

B. Retourner des informations sur toutes les bases de données

Cet exemple suivant affiche des informations sur toutes les bases de données sur le serveur exécutant SQL Server.

EXEC sp_helpdb;
GO