TechNet
Exporter (0) Imprimer
Développer tout

sys.dm_exec_xml_handles (Transact-SQL)

 

Retourne des informations sur les handles actifs qui ont été ouverts par sp_xml_preparedocument.

S'applique à : SQL Server (SQL Server 2008 via la version actuelle).
  
dm_exec_xml_handles (session_id | 0 )  

session_id | 0,
ID de la session. Si session_id est spécifié, cette fonction renvoie 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.

Nom de la colonneType de donnéesDescription
session_idintID de session de la session qui détient ce handle de document XML.
document_idintID de handle de document XML retourné par sp_xml_preparedocument.
namespace_document_idintID de handle interne utilisé pour le document d'espace de noms associé qui a été 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_handlevarbinary(64)Handle du texte du code SQL où le handle a été défini.
statement_start_offsetintNombre de caractères dans la procédure stockée ou le traitement en cours d'exécution auquel l'appel sp_xml_preparedocument se produit. Cette valeur peut être utilisée avec les fonctions de gestion dynamique sql_handle, statement_end_offset et sys.dm_exec_sql_text pour extraire l'instruction en cours d'exécution de la demande.
statement_end_offsetintNombre de caractères dans la procédure stockée ou le traitement en cours d'exécution auquel l'appel sp_xml_preparedocument se produit. Cette valeur peut être utilisée avec les fonctions de gestion dynamique sql_handle, statement_start_offset et sys.dm_exec_sql_text pour extraire l'instruction en cours d'exécution de la demande.
creation_timedatetimeHorodatage du moment où sp_xml_preparedocument a été appelé.
original_document_size_bytesbigintTaille du document XML non analysé, en octets.
original_namespace_document_size_bytesbigintTaille 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_callsbigintNombre d'appels OPENXML avec ce handle de document.
row_countbigintNombre de lignes retournées par tous les appels OPENXML précédents pour ce handle de document.
dormant_duration_msbigintNombre de millisecondes depuis le dernier appel OPENXML. Si OPENXML n'a pas été appelé, retourne le nombre de millisecondes depuis l'appel sp_xml_preparedocument.

La durée de vie du sql_handles utilisé pour récupérer le texte SQL qui a exécuté un appel à sp_xml_preparedocument est supérieure à celle du 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.

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 actuelle.

L'exemple suivant sélectionne tous les handles actives.

SELECT * FROM sys.dm_exec_xml_handles(0);  

Fonctions et vues de gestion dynamique (Transact-SQL)
Fonctions et vues de gestion dynamique relatives à l'exécution (Transact-SQL)

Ajouts de la communauté

Afficher:
© 2016 Microsoft