sp_invalidate_textptr (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

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 を使用すると、行内テキスト ポインターを無効にし、行内テキスト ポインターを追加するための空き領域を使用できます。

text in row オプションの詳細については、「sp_tableoption (Transact-SQL)」を参照してください。

アクセス許可

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

参照

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