sp_invalidate_textptr (Transact-SQL)sp_invalidate_textptr (Transact-SQL)

APLICA-SE A: simSQL Server nãoBanco de Dados SQL do Azure nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Invalida o ponteiro de texto em linha especificado ou todos os ponteiros de texto em linha, na transação.Invalidates the specified in-row text pointer, or all in-row text pointers, in the transaction. sp_invalidate_textptr pode ser usado apenas em ponteiros de texto em linha.sp_invalidate_textptr can be used only on in-row text pointers. Esses ponteiros são de tabelas que têm o texto em linha opção habilitada.These pointers are from tables that have the text in row option enabled.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

  
sp_invalidate_textptr [ [ @TextPtrValue = ] textptr_value ]  

ArgumentosArguments

[ @TextPtrValue = ] textptr_value É o ponteiro de texto em linha a ser invalidado.[ @TextPtrValue = ] textptr_value Is the in-row text pointer that to be invalidated. textptr_value está varbinary ( 16 ) , com um padrão NULL.textptr_value is varbinary( 16 ), with a default of NULL. Se for NULL, sp_invalidate_textptr invalida todos os ponteiros de texto em linha na transação.If NULL, sp_invalidate_textptr invalidates all in-row text pointers in the transaction.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

ComentáriosRemarks

O SQL ServerSQL Server permite um máximo de 1.024 ponteiros de texto em linha válidos ativos por transação, por banco de dados, no entanto, uma transação que inclui mais de um banco de dados pode ter 1.024 ponteiros de texto em linha em cada banco de dados.SQL ServerSQL Server 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 pode ser usado para invalidar ponteiros de texto em linha e, portanto, liberar espaço para ponteiros de texto em linha adicionais.sp_invalidate_textptr can be used to invalidate in-row text pointers and, therefore, free space for additional in-row text pointers.

Para obter mais informações sobre a opção text in row, consulte sp_tableoption (Transact-SQL).For more information about the text in row option, see sp_tableoption (Transact-SQL).

PermissõesPermissions

Requer associação à função pública .Requires membership in the public role.

Consulte tambémSee Also

Procedimentos armazenados do mecanismo de banco de dados (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL) System Stored Procedures (Transact-SQL)
sp_tableoption (Transact-SQL) sp_tableoption (Transact-SQL)
TEXTPTR (Transact-SQL) TEXTPTR (Transact-SQL)
TEXTVALID (Transact-SQL)TEXTVALID (Transact-SQL)