DATABASEPROPERTYEX (Transact-SQL)

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Pour une base de données spécifiée dans SQL Server, cette fonction retourne le paramètre actuel de l’option ou de la propriété de base de données spécifiée.

Conventions de la syntaxe Transact-SQL

Syntaxe

DATABASEPROPERTYEX ( database , property )  

Arguments

database
Expression spécifiant le nom de la base de données pour laquelle DATABASEPROPERTYEX retourne des informations sur la propriété nommée. Le type de données de database est nvarchar(128) .

Pour SQL Database, DATABASEPROPERTYEX a besoin du nom de la base de données active. Elle retourne la valeur NULL pour toutes les propriétés si un nom de base de données différent lui est donné.

property
Expression spécifiant le nom de la propriété de base de données à retourner. property possède le type de données varchar (128) et prend en charge l’une des valeurs contenues dans ce tableau :

Types de retour

sql_variant

Exceptions

Retourne NULL en cas d’erreur ou si un appelant n’est pas autorisé à voir l’objet.

Dans SQL Server, 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. Cette règle signifie que les fonctions intégrées générant des métadonnées, comme OBJECT_ID, peuvent retourner 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.

Notes

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

Exemples

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

Cet exemple retourne l’état de l’option de base de données AUTO_SHRINK pour la base de données AdventureWorks.

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

Voici le jeu de 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

Cet exemple retourne plusieurs attributs de la base de données AdventureWorks.

SELECT   
    DATABASEPROPERTYEX('AdventureWorks2022', 'Collation') AS Collation,  
    DATABASEPROPERTYEX('AdventureWorks2022', 'Edition') AS Edition,  
    DATABASEPROPERTYEX('AdventureWorks2022', 'ServiceObjective') AS ServiceObjective,  
    DATABASEPROPERTYEX('AdventureWorks2022', 'MaxSizeInBytes') AS MaxSizeInBytes  

Voici le jeu de résultats.

Collation                     Edition        ServiceObjective  MaxSizeInBytes  
----------------------------  -------------  ----------------  --------------  
SQL_Latin1_General_CP1_CI_AS  DataWarehouse  DW1000            5368709120  

C. Utiliser DATABASEPROPERTYEX pour vérifier la connexion au réplica

Quand vous utilisez la fonctionnalité de scale-out en lecture d’Azure SQL Database, vous pouvez vérifier si vous êtes connecté à un réplica en lecture seule en exécutant la requête suivante dans le contexte de votre base de données. Elle retourne READ_ONLY quand vous êtes connecté à un réplica en lecture seule. De cette façon, vous pouvez également identifier quand une requête s’exécute sur un réplica en lecture seule.

SELECT DATABASEPROPERTYEX(DB_NAME(), 'Updateability'); 

Voir aussi

ALTER DATABASE (Transact-SQL)
États d’une base de données
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
SERVERPROPERTY (Transact-SQL)