sp_invalidate_textptr (Transact-SQL)

適用対象: SQL サーバー

トランザクションで、指定された行内テキスト ポインターまたはすべての行内テキスト ポインターを無効にします。 sp_invalidate_textptr は、行内テキスト ポインターでのみ使用できます。 これらのポインターは、行内の text オプションが有効になっているテーブルからのポインターです。

Transact-SQL 構文表記規則

構文

  
sp_invalidate_textptr [ [ @TextPtrValue = ] textptr_value ]  

引数

[ @TextPtrValue = ] textptr_value 無効にする行内テキスト ポインターです。 textptr_value は varbinary(16)で、既定値は NULL です。 NULL の場合、 sp_invalidate_textptr はトランザクション内のすべての行内テキスト ポインターを無効にします。

リターン コードの値

0 (成功) または 1 (失敗)

解説

SQL Server では、データベースごとにトランザクションあたり最大 1,024 個のアクティブな有効な行内テキスト ポインターを使用できます。ただし、複数のデータベースにまたがるトランザクションでは、各データベースに 1,024 個の行内テキスト ポインターを含めることができます。 sp_invalidate_textptr を使用すると、行内テキスト ポインターを無効にし、行内テキスト ポインターを追加するための空き領域を増やすことができます。

行内テキスト オプションの詳細については、「 sp_tableoption (Transact-SQL)」を参照してください。

アクセス許可

ロール public のメンバーシップが必要です。

参照

データベース エンジン ストアド プロシージャ (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)
sp_tableoption (Transact-SQL)
TEXTPTR (Transact-SQL)
TEXTVALID (Transact-SQL)