DATABASEPROPERTYEX (Transact-SQL)

 

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabaseouiAzure SQL Data WarehouseouiParallel Data Warehouse

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

Topic link icon Conventions de la syntaxe Transact-SQL

-- Syntax for SQL Server, Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse  
  
DATABASEPROPERTYEX ( database , property )  

base de données
Est une expression qui représente le nom de la base de données pour lequel retourner les informations de propriété nommée. base de données est nvarchar (128).

Pour Base de données SQL, doit être le nom de la base de données actuelle. Retourne la valeur NULL pour toutes les propriétés si un nom de base de données différent est fourni.

propriété
Expression représentant le nom de la propriété de base de données à renvoyer. propriété est varchar (128), et peut prendre l’une des valeurs suivantes. Le type de retour est sql_variant. Le tableau qui suit indique le type de données de base pour chaque valeur de propriété.

System_CAPS_ICON_note.jpg Remarque


Si la base de données n'est pas démarrée, les propriétés que le serveur SQL Server récupère en accédant directement à la base de données, au lieu de récupérer la valeur des métadonnées, retournent NULL. Cette situation se présente lorsque la propriété AUTO_CLOSE de la base de données a la valeur ON ou que la base de données est hors connexion.

PropriétéDescriptionValeur retournée
ClassementNom du classement par défaut de la base de donnéesNom du classement

NULL = la base de données n'est pas démarrée.

Type de données de base : nvarchar (128)
ComparisonStyleStyle de comparaison Windows du classement. ComparisonStyle est une bitmap qui est calculée en utilisant les valeurs suivantes pour les styles possibles.

Ignorer la casse : 1

Ignorer les accents : 2

Ignorer les caractères Kana : 65536

Ignorer la largeur : 131072

 

Par exemple, la valeur par défaut 196609 est le résultat de la combinaison des options permettant d'ignorer la casse, le type de caractères Kana et la largeur.
Retourne le style de comparaison.

Renvoie 0 pour tous les classements binaires.

Type de données de base : int
ÉditionÉdition de la base de données ou couche de service.Applies to: Base de données Azure SQL, SQL Data Warehouse.

 

Web = Édition Web de la base de données

Business = Édition Business de la base de données

Basic

Standard

Premium

Système (pour la base de données master)

NULL = la base de données n'est pas démarrée.

Type de données de base : nvarchar(64)
IsAnsiNullDefaultLa base de données suit les règles ISO d'autorisation des valeurs Null.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsAnsiNullsEnabledToutes les comparaisons à une valeur NULL produisent le résultat UNKNOWN (inconnu).1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsAnsiPaddingEnabledLes chaînes sont complétées à la même longueur avant leur comparaison ou insertion.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsAnsiWarningsEnabledDes messages d'erreur ou d'avertissement sont affichés si des conditions d'erreur standard apparaissent.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsArithmeticAbortEnabledUne requête s'arrête lorsqu'un dépassement de capacité ou une division par zéro se produit durant son exécution.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsAutoCloseLa base de données est fermée correctement et ses ressources sont libérées après la fin de session du dernier utilisateur.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsAutoCreateStatisticsL'optimiseur de requête crée des statistiques de colonnes uniques, selon les besoins, pour améliorer les performances des requêtes.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsAutoCreateStatisticsIncrementalLes statistiques de colonnes uniques créées automatiquement sont incrémentielles lorsque cela est possible.S'applique à: SQL Server 2014 et SQL Server 2016.

 

1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsAutoShrinkLes fichiers de base de données peuvent faire l'objet d'une réduction périodique automatique.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsAutoUpdateStatisticsL'optimiseur de requête met à jour les statistiques existantes lorsqu'elles sont utilisées par une requête et qu'elles sont peut-être obsolètes.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsCloneBase de données est un schéma et des statistiques seule copie d’une base de données utilisateur.S’applique aux: SQL Server 2014 Service Pack 2.

 

1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsCloseCursorsOnCommitEnabledLes curseurs ouverts lors de la validation d'une transaction sont fermés.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsFulltextEnabledL'indexation sémantique et de texte intégral est activée pour la base de données.S'applique à: SQL Server 2008 et SQL Server 2016.

 

1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int

 Remarque : la valeur de cette propriété n’a aucun effet. Les bases de données utilisateur sont toujours activées pour la recherche en texte intégral. Cette colonne sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette colonne dans de nouveaux travaux de développement et modifiez dès que possible les applications qui utilisent actuellement l'une de ces colonnes.
IsInStandByLa base de données est en ligne en lecture seule, avec la restauration du journal autorisée.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsLocalCursorsDefaultLes déclarations de curseurs prennent la valeur LOCAL par défaut.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsMemoryOptimizedElevateToSnapshotEnabledL'isolation SNAPSHOT permet d'accéder aux tables optimisées en mémoire lorsque le paramètre de session TRANSACTION ISOLATION LEVEL a une valeur correspondant à un niveau d'isolation inférieur, READ COMMITTED ou READ UNCOMMITTED.S'applique à: SQL Server 2014 et SQL Server 2016.

 

1 = TRUE

0 = FALSE

Type de données de base : int
IsMergePublishedLes tables d'une base de données peuvent être publiées pour la réplication de fusion, si la réplication est installée.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsNullConcatUn opérande de concaténation Null produit NULL.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsNumericRoundAbortEnabledDes erreurs sont générées lors d'une perte de précision dans une expression.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsParameterizationForcedL'option SET de base de données PARAMETERIZATION a la valeur FORCED.1 = TRUE

0 = FALSE

NULL = entrée non valide
IsQuotedIdentifiersEnabledLes guillemets doubles peuvent être utilisés dans les identificateurs.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsPublishedLes tables de la base de données peuvent être publiées pour la réplication transactionnelle ou d'instantané, si la réplication est installée.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsRecursiveTriggersEnabledLe fonctionnement récursif des déclencheurs est activé.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsSubscribedLa base de données est abonnée à une publication.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsSyncWithBackupLa base de données est soit une base de données publiée, soit une base de données de distribution ; en outre, elle peut être restaurée sans interrompre la réplication transactionnelle.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsTornPageDetectionEnabledLe Moteur de base de données SQL Server détecte les opérations d'E/S interrompues à la suite d'une coupure de courant ou de toute autre panne du système.1 = TRUE

0 = FALSE

NULL = entrée non valide

Type de données de base : int
IsXTPSupportedIndique si la base de données prend en charge l’OLTP en mémoire, par exemple, créer et à utiliser des tables optimisées en mémoire et des modules compilés en mode natif.

Spécifiques à SQL Server:

IsXTPSupported est indépendante de l’existence des groupes de fichiers MEMORY_OPTIMIZED_DATA, qui est requis pour créer des objets OLTP en mémoire.
Applies to: SQL Server (SQL Server 2014 through SQL Server 2016), Base de données SQL.

 S’applique aux: Base de données Azure SQL et SQL Server commençant SQL Server 2016.

 

1 = TRUE

0 = FALSE

NULL = entrée non valide, une erreur, ou non applicable

Type de données de base : int
LCIDL’identificateur de paramètres régionaux Windows (LCID) du classement.Valeur LCID (au format décimal).

Type de données de base : int
MaxSizeInBytesTaille maximale de la base de données en octets.Applies to: Base de données Azure SQL, SQL Data Warehouse.

 

1073741824

5368709120

10737418240

21474836480

32212254720

42949672960

53687091200

NULL = base de données n’est pas démarré.

Type de données de base : bigint
RécupérationMode de récupération de la base de donnéesFULL = mode de récupération complète

BULK_LOGGED = mode de récupération utilisant les journaux de transactions

SIMPLE = mode de récupération simple

Type de données de base : nvarchar (128)
ServiceObjectiveDécrit le niveau de performances de la base de données Base de données SQL ou SQL Data Warehouse.Les valeurs possibles sont les suivantes :

NULL : base de données n’a ne pas démarré

Shared (pour l'édition Web/Business)

Basic

S0

S1

S2

S3

P1

P2

P3

ElasticPool

Système (pour base de données master)

Type de données de base : nvarchar (32)
ServiceObjectiveIdID de l'objectif de service dans la Base de données SQL.uniqueidentifier qui identifie l’objectif de service.
SQLSortOrderID d'ordre de tri SQL Server pris en charge dans les versions antérieures de SQL Server.0 = la base de données utilise le classement Windows

>0 = ID d'ordre de tri SQL Server

NULL = entrée non valide ou la base de données n'est pas démarrée

Type de données de base : tinyint
ÉtatÉtat de la base de données.ONLINE = la base de données est disponible pour la requête.

 Remarque : l’état en ligne peut-être être renvoyée lors de la base de données est ouverte et n’est pas encore récupérée. Pour déterminer quand une base de données peut accepter les connexions, interrogez la propriété de classement DATABASEPROPERTYEX. La base de données peut accepter les connexions lorsque le classement de base de données retourne une valeur non NULL. Pour toujours des bases de données, interrogez les colonnes database_state ou database_state_desc de sys.dm_hadr_database_replica_states.

OFFLINE = la base de données a été explicitement mise hors connexion.

RESTORING = la base de données est en cours de restauration.

RECOVERING = la base de données est en cours de récupération et n'est toujours pas disponible pour les requêtes.

SUSPECT = la base de données n'a pas été récupérée.

EMERGENCY = la base de données se trouve dans un état d'urgence en lecture seule. L'accès est limité aux membres sysadmin.

Type de données de base : nvarchar (128)
UpdateabilityIndique si les données peuvent être modifiées.READ_ONLY = les données peuvent être lues mais pas modifiées.

READ_WRITE = les données peuvent être lues et modifiées.

Type de données de base : nvarchar (128)
UserAccessDéfinit les utilisateurs autorisés à accéder à la base de données.SINGLE_USER = un seul utilisateur db_owner, dbcreator ou sysadmin à la fois

RESTRICTED_USER = seuls les membres des rôles db_owner, dbcreator et sysadmin

MULTI_USER = tous les utilisateurs

Type de données de base : nvarchar (128)
VersionNuméro de version interne du code SQL Server avec lequel la base de données a été créée. Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.Numéro de version = la base de données est ouverte.

NULL = la base de données n'est pas démarrée.

Type de données de base : int

sql_variant

Retourne la valeur NULL en cas d'erreur ou si un appelant n'est pas autorisé à afficher 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. 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 Metadata Visibility Configuration.

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

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('AdventureWorks2014', '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 plusieurs attributs de la AdventureWorks base de données.

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

Voici l'ensemble des résultats.

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

MODIFIER la base de données (Transact-SQL)
États de la base de données
Sys.Databases (Transact-SQL)
Sys.database_files (Transact-SQL)
SERVERPROPERTY (Transact-SQL)

Ajouts de la communauté

AJOUTER
Afficher: