sp_xml_removedocument (Transact-SQL)
Applies to:
SQL Server
Azure SQL Database
Azure SQL Managed Instance
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.
Transact-SQL syntax conventions
Syntax
sp_xml_removedocument hdoc
[ ; ]
Arguments
Important
Arguments for extended stored procedures must be entered in the specific order as described in the Syntax section. If the parameters are entered out of order, an error message occurs.
hdoc
The handle to the newly created document. A handle that isn't valid returns an error. hdoc is an integer.
Return code values
0
(success) or > 0
(failure).
Permissions
Requires membership in the public role.
Examples
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;