sys.dm_exec_xml_handles (Transact-SQL)
S’applique à :
SQL ServerAzure SQL Managed Instance
Retourne des informations sur les handles actifs ouverts par sp_xml_preparedocument.
Syntaxe
dm_exec_xml_handles (session_id | 0 )
Arguments
session_id | 0,
ID de la session. Si session_id est spécifié, cette fonction retourne des informations sur les handles XML dans la session spécifiée.
Si 0 est spécifié, la fonction renvoie des informations sur tous les handles XML dans toutes les sessions.
Table retournée
| Nom de la colonne | Type de données | Description |
|---|---|---|
| session_id | int | ID de session de la session qui détient ce handle de document XML. |
| document_id | int | ID de handle de document XML retourné par sp_xml_preparedocument. |
| namespace_document_id | int | ID de handle interne utilisé pour le document d’espace de noms associé passé en tant que troisième paramètre à sp_xml_preparedocument. NULL s'il n'y a pas de document d'espace de noms. |
| sql_handle | varbinary(64) | Handle du texte du code SQL où le handle a été défini. |
| statement_start_offset | int | Nombre de caractères dans le lot ou la procédure stockée en cours d’exécution auquel l’appel sp_xml_preparedocument se produit. Peut être utilisé avec l’sql_handle, le statement_end_offset et la fonction de gestion dynamique sys.dm_exec_sql_text pour récupérer l’instruction en cours d’exécution pour la requête. |
| statement_end_offset | int | Nombre de caractères dans le lot ou la procédure stockée en cours d’exécution auquel l’appel sp_xml_preparedocument se produit. Peut être utilisé avec l’sql_handle, le statement_start_offset et la fonction de gestion dynamique sys.dm_exec_sql_text pour récupérer l’instruction en cours d’exécution pour la requête. |
| creation_time | datetime | Horodatage lorsque sp_xml_preparedocument a été appelé. |
| original_document_size_bytes | bigint | Taille du document XML non analysé, en octets. |
| original_namespace_document_size_bytes | bigint | Taille du document d'espace de noms XML non analysé, en octets. NULL s'il n'y a pas de document d'espace de noms. |
| num_openxml_calls | bigint | Nombre d'appels OPENXML avec ce handle de document. |
| row_count | bigint | Nombre de lignes retournées par tous les appels OPENXML précédents pour ce handle de document. |
| dormant_duration_ms | bigint | Nombre de millisecondes depuis le dernier appel OPENXML. Si OPENXML n’a pas été appelé, retourne des millisecondes depuis l’appel sp_xml_preparedocumen t. |
Notes
Durée de vie de sql_handles utilisée pour récupérer le texte SQL qui a exécuté un appel pour sp_xml_preparedocument a dépassé le plan mis en cache utilisé pour exécuter la requête. Si le texte de la requête n'est pas disponible dans le cache, les données ne peuvent pas être récupérées à l'aide des informations fournies dans le résultat de fonction. Cela peut se produire si vous exécutez de nombreux traitements de grande taille.
autorisations
Requiert l'autorisation VIEW SERVER STATE sur le serveur afin d'afficher toutes les sessions ou les ID de session qui ne sont pas détenus par l'appelant. Un appelant peut toujours voir les données de son propre ID de session actuel.
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 sélectionne tous les handles actives.
SELECT * FROM sys.dm_exec_xml_handles(0);
Voir aussi
Fonctions et vues de gestion dynamique (Transact-SQL)
Fonctions et vues de gestion dynamique relatives à l'exécution (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)