sp_invalidate_textptr (Transact-SQL)

Erklärt den angegebenen Textzeiger in Zeilen oder alle Textzeiger in Zeilen in der Transaktion für ungültig. sp_invalidate_textptr kann nur für Textzeiger in Zeilen verwendet werden. Diese Zeiger stammen aus Tabellen, bei denen die Option text in row aktiviert ist.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_invalidate_textptr [ [ @TextPtrValue = ] textptr_value ]

Argumente

  • [ @TextPtrValue= ] textptr_value
    Der Textzeiger in Zeilen, der ungültig wird. textptr_value ist vom Datentyp varbinary(16); der Standardwert ist NULL.Wenn NULL festgelegt ist, werden alle Textzeiger in Zeilen in der Transaktion durch sp_invalidate_textptr ungültig.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

SQL Server lässt pro Transaktion in einer Datenbank maximal 1.024 aktive Textzeiger in Zeilen zu; eine Transaktion, die mehr als eine Datenbank einbezieht, kann 1.024 Textzeiger in Zeilen in jeder Datenbank haben. sp_invalidate_textptr kann verwendet werden, damit Textzeiger in Zeilen ungültig werden und somit für zusätzliche Textzeiger in Zeilen Speicherplatz frei wird.

Weitere Informationen zur Option text in row finden Sie unter sp_tableoption (Transact-SQL).

Berechtigungen

Erfordert die Mitgliedschaft in der public-Rolle.