sp_xml_removedocument (Transact-SQL)

APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Removes the internal representation of the XML document specified by the document handle and invalidates the document handle.


A parsed document is stored in the internal cache of SQL Server. The MSXML parser (Msxmlsql.dll) uses one-eighth the total memory available for SQL Server. To avoid running out of memory, run sp_xml_removedocument to free up the memory.

Topic link icon Transact-SQL Syntax Conventions


sp_xml_removedocument hdoc  


Is the handle to the newly created document. A handle that is not valid returns an error. hdoc is an integer.

Return Code Values

0 (success) or >0 (failure)


Requires membership in the public role.


The following example removes the internal representation of an XML document. The handle to the document is provided as input.

EXEC sp_xml_removedocument @hdoc;  

See Also

System Stored Procedures (Transact-SQL)
XML Stored Procedures (Transact-SQL)
sys.dm_exec_xml_handles (Transact-SQL)
OPENXML (Transact-SQL)