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;