sys.dm_exec_xml_handles (Transact-SQL)sys.dm_exec_xml_handles (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabaseouiAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabaseyesAzure SQL Data Warehouse noParallel Data Warehouse

Retourne des informations sur les handles actifs qui ont été ouverts par sp_xml_preparedocument.Returns information about active handles that have been opened by sp_xml_preparedocument.

SyntaxeSyntax


dm_exec_xml_handles (session_id | 0 )  

ArgumentsArguments

session_id | 0,session_id | 0,
ID de la session.ID of the session. Si session_id est spécifié, cette fonction retourne des informations sur les handles XML dans la session spécifiée.If session_id is specified, this function returns information about XML handles in the specified session.

Si 0 est spécifié, la fonction renvoie des informations sur tous les handles XML dans toutes les sessions.If 0 is specified, the function returns information about all XML handles for all sessions.

Table retournéeTable Returned

Nom de colonneColumn name Type de donnéesData type DescriptionDescription
session_idsession_id intint ID de session de la session qui détient ce handle de document XML.Session ID of the session that holds this XML document handle.
document_iddocument_id intint ID de handle de document XML retourné par sp_xml_preparedocument.XML document handle ID returned by sp_xml_preparedocument.
namespace_document_idnamespace_document_id intint ID de handle interne utilisé pour le document de l’espace de noms associé qui a été passé en tant que troisième paramètre à sp_xml_preparedocument.Internal handle ID used for the associated namespace document that has been passed as the third parameter to sp_xml_preparedocument. NULL s'il n'y a pas de document d'espace de noms.NULL if there is no namespace document.
sql_handlesql_handle varbinary(64)varbinary(64) Handle du texte du code SQL où le handle a été défini.Handle to the text of the SQL code where the handle has been defined.
statement_start_offsetstatement_start_offset intint Nombre de caractères dans l’en cours d’exécution par lots ou la procédure stockée à laquelle le sp_xml_preparedocument appel se produit.Number of characters into the currently executing batch or stored procedure at which the sp_xml_preparedocument call occurs. Peut être utilisé avec le sql_handle, le statement_end_offsetet le sys.dm_exec_sql_text fonction de gestion dynamique pour extraire l’instruction en cours d’exécution de la demande.Can be used together with the sql_handle, the statement_end_offset, and the sys.dm_exec_sql_text dynamic management function to retrieve the currently executing statement for the request.
statement_end_offsetstatement_end_offset intint Nombre de caractères dans l’en cours d’exécution par lots ou la procédure stockée à laquelle le sp_xml_preparedocument appel se produit.Number of characters into the currently executing batch or stored procedure at which the sp_xml_preparedocument call occurs. Peut être utilisé avec le sql_handle, le statement_start_offsetet le sys.dm_exec_sql_text fonction de gestion dynamique pour extraire l’instruction en cours d’exécution de la demande.Can be used together with the sql_handle, the statement_start_offset, and the sys.dm_exec_sql_text dynamic management function to retrieve the currently executing statement for the request.
creation_timecreation_time datetimedatetime Horodatage lors de la sp_xml_preparedocument a été appelée.Timestamp when sp_xml_preparedocument was called.
original_document_size_bytesoriginal_document_size_bytes bigintbigint Taille du document XML non analysé, en octets.Size of the unparsed XML document in bytes.
original_namespace_document_size_bytesoriginal_namespace_document_size_bytes bigintbigint Taille du document d'espace de noms XML non analysé, en octets.Size of the unparsed XML namespace document, in bytes. NULL s'il n'y a pas de document d'espace de noms.NULL if there is no namespace document.
num_openxml_callsnum_openxml_calls bigintbigint Nombre d'appels OPENXML avec ce handle de document.Number of OPENXML calls with this document handle.
row_countrow_count bigintbigint Nombre de lignes retournées par tous les appels OPENXML précédents pour ce handle de document.Number of rows returned by all previous OPENXML calls for this document handle.
dormant_duration_msdormant_duration_ms bigintbigint Nombre de millisecondes depuis le dernier appel OPENXML.Milliseconds since the last OPENXML call. Si OPENXML n’a pas été appelé, retourne le nombre de millisecondes depuis le sp_xml_preparedocumentappel.If OPENXML has not been called, returns milliseconds since the sp_xml_preparedocument call.

NotesRemarks

La durée de vie de 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.The lifetime of sql_handles used to retrieve the SQL text that executed a call to sp_xml_preparedocument outlives the cached plan used to execute the query. 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.If the query text is not available in the cache, the data cannot be retrieved using the information provided in the function result. Cela peut se produire si vous exécutez de nombreux traitements de grande taille.This can occur if you are running many large batches.

PermissionsPermissions

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.Requires VIEW SERVER STATE permission on the server to see all sessions or session IDs that are not owned by the caller. Un appelant peut toujours voir les données de son propre ID de session actuelle.A caller can always see the data for his or her own current session ID.

ExemplesExamples

L'exemple suivant sélectionne tous les handles actives.The following example selects all active handles.

SELECT * FROM sys.dm_exec_xml_handles(0);  

Voir aussiSee Also

Fonctions et vues de gestion dynamique (Transact-SQL) Dynamic Management Views and Functions (Transact-SQL)
Les fonctions et vues de gestion dynamique ( liées à l’exécution Transact-SQL )Execution Related Dynamic Management Views and Functions (Transact-SQL)