DATABASEPROPERTYEX (Transact-SQL)

Mis à jour : 17 juillet 2006

Retourne le paramètre actuel de l'option ou de la propriété de la base de données spécifiée.

Conventions de la syntaxe de Transact-SQL

Syntaxe

DATABASEPROPERTYEX ( database , property )

Arguments

• database
  Expression représentant le nom de la base de données pour laquelle retourner l'information sur la propriété nommée. database est de type nvarchar(128).

• property
  Expression représentant le nom de la propriété de base de données à renvoyer. property est de type varchar(128) et peut prendre l'une des valeurs suivantes : Le type de retour est sql_variant. Le tableau suivant montre le type de données de base de chaque valeur de propriété.

  Remarque :
  Si la base de données n'est pas démarrée, les propriétés que le moteur de base de données SQL Server 2005 de Microsoft extrait en accédant à la base de données directement, et non en récupérant la valeur dans les métadonnées, retournent NULL. Cette situation se présente lorsque la propriété AUTO_CLOSE de la base de données a pour valeur ON ou que la base de données est hors connexion.

  Propriété

Exceptions

Retourne la valeur NULL en cas d'erreur ou si un appelant n'est pas autorisé à afficher l'objet.

Dans SQL Server 2005, un utilisateur peut voir uniquement les métadonnées des éléments sécurisables qui lui appartiennent ou pour lesquels il dispose d'un droit d'accès. Cela signifie que les fonctions intégrées générant des métadonnées, telles que OBJECT_ID, peuvent retourner la valeur NULL si l'utilisateur ne dispose d'aucune autorisation sur l'objet. Pour plus d'informations, consultez Configuration de la visibilité des métadonnées et Dépannage de la visibilité des métadonnées.

Notes

DATABASEPROPERTYEX retourne un seul paramètre de propriété à la fois. Pour afficher plusieurs paramètres de propriété, utilisez l'affichage catalogue sys.databases.

Types de retour

sql_variant

Exemples

A. Récupération de l'état de l'option de base de données AUTO_SHRINK

L'exemple suivant retourne l'état de l'option de base de données AUTO_SHRINK de la base de données AdventureWorks.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'IsAutoShrink');

Voici l'ensemble des résultats. Cela indique que la base de données AUTO_SHRINK est désactivée.

------------------
0

B. Récupération du classement par défaut d'une base de données

L'exemple suivant retourne le nom du classement par défaut de la base de données AdventureWorks.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'Collation');

Voici l'ensemble des résultats.

------------------------------
SQL_Latin1_General_CP1_CI_AI

Voir aussi

Référence

ALTER DATABASE (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)

Autres ressources

États d'une base de données
Définition des options de base de données
Utilisation de données sql_variant

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Nouveau contenu : Ajout de la section « Exceptions ».
14 avril 2006	Contenu modifié : Correction et enrichissement des descriptions de ComparisonStyle et LCID.