Skip to content

Latest commit

 

History

History
60 lines (43 loc) · 2.49 KB

sp-invalidate-textptr-transact-sql.md

File metadata and controls

60 lines (43 loc) · 2.49 KB
title description author ms.author ms.reviewer ms.date ms.service ms.subservice ms.topic f1_keywords helpviewer_keywords dev_langs
sp_invalidate_textptr (Transact-SQL)
sp_invalidate_textptr invalidates the specified in-row text pointer, or all in-row text pointers, in the transaction.
markingmyname
maghan
randolphwest
07/16/2024
sql
system-objects
reference
sp_invalidate_textptr_TSQL
sp_invalidate_textptr
sp_invalidate_textptr
TSQL

sp_invalidate_textptr (Transact-SQL)

[!INCLUDE SQL Server]

Invalidates the specified in-row text pointer, or all in-row text pointers, in the transaction. sp_invalidate_textptr can be used only on in-row text pointers. These pointers are from tables that have the text in row option enabled.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

sp_invalidate_textptr [ [ @TextPtrValue = ] TextPtrValue ]
[ ; ]

Arguments

[ @TextPtrValue = ] TextPtrValue

The in-row text pointer that to be invalidated. @TextPtrValue is varbinary(16), with a default of 0x00. If NULL, sp_invalidate_textptr invalidates all in-row text pointers in the transaction.

Return code values

0 (success) or 1 (failure).

Remarks

[!INCLUDE ssNoVersion] allows for a maximum of 1,024 active valid in-row text pointers per transaction per database. However, a transaction spanning more than one database can have 1,024 in-row text pointers in each database. sp_invalidate_textptr can be used to invalidate in-row text pointers and, therefore, free space for more in-row text pointers.

For more information about the text in row option, see sp_tableoption.

Permissions

Requires membership in the public role.

Related content