Partilhar via


sp_invalidate_textptr (Transact-SQL)

Aplica-se: SQL Server

Invalida o ponteiro de texto em linha especificado ou todos os ponteiros de texto em linha, na transação. sp_invalidate_textptr pode ser usado apenas em ponteiros de texto em linha. Esses ponteiros são de tabelas que têm a opção de texto em linha habilitada.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@TextPtrValue [ = ] Valor de TextPtr

O ponteiro de texto em linha que deve ser invalidado. @TextPtrValue é varbinary(16), com um padrão de 0x00. Se NULL, sp_invalidate_textptr invalida todos os ponteiros de texto em linha na transação.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

O SQL Server permite um máximo de 1.024 ponteiros de texto válidos ativos em linha por transação por banco de dados. No entanto, uma transação que abrange mais de um banco de dados pode ter 1.024 ponteiros de texto em linha em cada banco de dados. sp_invalidate_textptr pode ser usado para invalidar ponteiros de texto em linha e, portanto, liberar espaço para mais ponteiros de texto em linha.

Para obter mais informações sobre a opção de texto em linha, consulte sp_tableoption.

Permissões

Requer associação à função pública .