sys.dm_clr_appdomains (Transact-SQL)
S'applique à : 
SQL Server
Renvoie une ligne pour chaque domaine d'application du serveur. Le domaine d’application (AppDomain) est une construction dans le Common Language Runtime (CLR) de Microsoft .NET Framework, qui est l’unité d’isolation pour une application. Vous pouvez utiliser cette vue pour comprendre et résoudre les problèmes liés aux objets d’intégration CLR qui s’exécutent dans Microsoft SQL Server.
Il existe plusieurs types d'objets de base de données managés d'intégration CLR. Pour obtenir des informations générales sur ces objets, consultez Génération d’objets de base de données avec l’intégration clR (Common Language Runtime). Chaque fois que ces objets sont exécutés, SQL Server crée un AppDomain sous lequel il peut charger et exécuter le code requis. Le niveau d’isolation d’un AppDomain est un AppDomain par base de données par propriétaire. Autrement dit, tous les objets CLR appartenant à un utilisateur sont toujours exécutés dans le même AppDomain par base de données (si un utilisateur inscrit des objets de base de données CLR dans différentes bases de données, les objets de base de données CLR s’exécutent dans différents domaines d’application). Un AppDomain n’est pas détruit une fois l’exécution du code terminée. Au lieu de cela, il est mis en cache en mémoire pour les prochaines exécutions. Les performances en sont alors améliorées.
Pour plus d’informations, consultez Domaines d’application.
| Nom de la colonne | Type de données | Description |
|---|---|---|
| appdomain_address | varbinary(8) | Adresse du Domaine d’application. Tous les objets de base de données managés appartenant à un utilisateur sont toujours chargés dans le même AppDomain. Vous pouvez utiliser cette colonne pour rechercher tous les assemblys actuellement chargés dans cet AppDomain dans sys.dm_clr_loaded_assemblies. |
| appdomain_id | int | ID du Domaine d’application. Chaque AppDomain a un ID unique. |
| appdomain_name | varchar(386) | Nom du Domaine d’application attribué par SQL Server. |
| creation_time | datetime | Heure de création de l’AppDomain. Étant donné que les AppDomains sont mis en cache et réutilisés pour de meilleures performances, creation_time n’est pas nécessairement le moment où le code a été exécuté. |
| db_id | int | ID de la base de données dans laquelle cet AppDomain a été créé. Le code stocké dans deux bases de données différentes ne peut pas partager un AppDomain. |
| user_id | int | ID de l’utilisateur dont les objets peuvent s’exécuter dans ce AppDomain. |
| state | nvarchar(128) | Descripteur pour l’état actuel du Domaine d’application. Un domaine d'application AppDomain peut être dans différents états de sa création à sa suppression. Pour plus d’informations, consultez la section Remarques de cet article. |
| strong_refcount | int | Nombre de références fortes à ce AppDomain. Cela reflète le nombre de lots en cours d’exécution qui utilisent ce AppDomain. L’exécution de cette vue crée un refcount fort ; même si aucun code n’est en cours d’exécution, strong_refcount aura la valeur 1. |
| weak_refcount | int | Nombre de références faibles à ce AppDomain. Cela indique le nombre d’objets à l’intérieur de l’AppDomain mis en cache. Lorsque vous exécutez un objet de base de données managé, SQL Server le met en cache à l’intérieur de l’AppDomain pour une réutilisation ultérieure. Les performances en sont alors améliorées. |
| cost | int | Coût de l’AppDomain. Plus le coût est élevé, plus ce AppDomain est susceptible d’être déchargé sous pression mémoire. Le coût dépend généralement de la quantité de mémoire nécessaire pour recréer ce AppDomain. |
| value | int | Valeur du Domaine d’application. Plus la valeur est faible, plus ce AppDomain doit être déchargé sous pression mémoire. La valeur dépend généralement du nombre de connexions ou de lots qui utilisent ce AppDomain. |
| total_processor_time_ms | bigint | Temps processeur total, en millisecondes, utilisé par tous les threads lors de l'exécution dans le domaine d'application actuel depuis le démarrage du processus. Cela équivaut à System.AppDomain.MonitoringTotalProcessorTime. |
| total_allocated_memory_kb | bigint | Taille totale, en kilo-octets, de toutes les allocations mémoire faites par le domaine d'application depuis sa création, sans soustraction de la mémoire recueillie. Cela équivaut à System.AppDomain.MonitoringTotalAllocatedMemorySize. |
| survived_memory_kb | bigint | Nombre de kilo-octets qui ont survécu à la dernière collection bloquante complète et connus pour être référencés par le domaine d'application actuel. Cela équivaut à System.AppDomain.MonitoringSurvivedMemorySize. |
Notes
Il existe une relation un-à-plusieurs entre dm_clr_appdomains.appdomain_address et dm_clr_loaded_assemblies.appdomain_address.
Les tableaux suivants répertorient les valeurs d’état possibles, leurs descriptions et quand elles se produisent dans le cycle de vie AppDomain. Vous pouvez utiliser ces informations pour suivre le cycle de vie d’un AppDomain et surveiller le déchargement d’instances AppDomain suspectes ou répétitives, sans avoir à analyser le journal des événements Windows.
Initialisation du domaine d'application AppDomain
| State | Description |
|---|---|
| E_APPDOMAIN_CREATING | AppDomain est en cours de création. |
Utilisation du domaine d'application AppDomain
| State | Description |
|---|---|
| E_APPDOMAIN_SHARED | Le runtime AppDomain est prêt à être utilisé par plusieurs utilisateurs. |
| E_APPDOMAIN_SINGLEUSER | AppDomain est prêt à être utilisé dans les opérations DDL. Ceux-ci diffèrent d'E_APPDOMAIN_SHARED en ceci que les domaines d'application AppDomains partagés sont utilisés pour les exécutions d'intégration du CLR par opposition aux opérations DDL. Ces domaines d'application AppDomains sont isolés d'autres opérations simultanées. |
| E_APPDOMAIN_DOOMED | AppDomain est planifié pour être déchargé, mais il existe actuellement des threads en cours d’exécution. |
Suppression du domaine d'application AppDomain
| State | Description |
|---|---|
| E_APPDOMAIN_UNLOADING | SQL Server a demandé que le CLR décharge l’AppDomain, généralement parce que l’assembly qui contient les objets de base de données managés a été modifié ou supprimé. |
| E_APPDOMAIN_UNLOADED | Le CLR a déchargé l’AppDomain. Il s’agit généralement du résultat d’une procédure d’escalade en raison de ThreadAbort, OutOfMemory ou d’une exception non gérée dans le code utilisateur. |
| E_APPDOMAIN_ENQUEUE_DESTROY | AppDomain a été déchargé dans CLR et défini pour être détruit par SQL Server. |
| E_APPDOMAIN_DESTROY | AppDomain est en cours de destruction par SQL Server. |
| E_APPDOMAIN_ZOMBIE | L’AppDomain a été détruit par SQL Server . Toutefois, toutes les références à AppDomain n’ont pas été nettoyées. |
autorisations
Nécessite l'autorisation VIEW SERVER STATE sur la base de données.
Autorisations pour SQL Server 2022 (et versions plus récentes)
Nécessite l’autorisation VIEW SERVER PERFORMANCE STATE sur le serveur.
Exemples
L’exemple suivant montre comment afficher les détails d’un AppDomain pour un assembly donné :
select appdomain_id, creation_time, db_id, user_id, state
from sys.dm_clr_appdomains a
where appdomain_address =
(select appdomain_address
from sys.dm_clr_loaded_assemblies
where assembly_id = 500);
L’exemple suivant montre comment afficher tous les assemblys dans un AppDomain donné :
select a.name, a.assembly_id, a.permission_set_desc, a.is_visible, a.create_date, l.load_time
from sys.dm_clr_loaded_assemblies as l
inner join sys.assemblies as a
on l.assembly_id = a.assembly_id
where l.appdomain_address =
(select appdomain_address
from sys.dm_clr_appdomains
where appdomain_id = 15);
Voir aussi
sys.dm_clr_loaded_assemblies (Transact-SQL)
Vues de gestion dynamique liées au Common Language Runtime (Transact-SQL)