table_name . dest_column_name

要更新的表以及 text、ntext 或 image 列的名称。表名和列名必须符合标识符规则。可以选择是否指定数据库名和所有者名。

dest_text_ptr

指向要更新的 text、ntext 或 image 数据的文本指针的值（由 TEXTPTR 函数返回）。dest_text_ptr 必须为数据类型 binary(16)。

insert_offset

以零为基的更新起始位置。对于 text 或 image 列，insert_offset 是在插入新数据前要从现有列的起点跳过的字节数。对于 ntext 列，insert_offset 是字符数（每个 ntext 字符占用 2 个字节）。从此基数为零的起始点开始的现有 text、ntext 或 image 数据向右移，为新数据留出空间。值为 0 表示将新数据插入现有数据的开始处。值为 NULL 则将新数据追加到现有数据值后。

delete_length

从 insert_offset 位置开始的、要从现有 text、ntext 或 image 列中删除的数据长度。delete_length 值对于 text 和 image 列用字节指定，对于 ntext 列用字符指定。每个 ntext 字符占用 2 个字节。值为 0 表示不删除数据。值为 NULL 则删除现有 text 或 image 列中从 insert_offset 位置开始到末尾的所有数据。

WITH LOG

日志记录由数据库的当前恢复模式决定。

inserted_data

要插入现有 text、ntext 或 image 列的 insert_offset 位置的数据。这是单个 char、nchar、varchar、nvarchar、binary、varbinary、text、ntext 或 image 值。inserted_data 可以是文字或变量。

table_name.src_column_name

用作插入数据源的表或 text、ntext 或 image 列的名称。表名和列名必须符合标识符规则。

src_text_ptr

指向用作插入数据源的 text、ntext 或 image 列的文本指针值（由 TEXTPTR 函数返回）。

注意：
scr_text_ptr 的值不能与 dest_text_ptr 的值相同。

新插入的数据可以是单个 inserted_data 常量、表名、列名或文本指针。

为获得最佳性能，建议在插入或更新 text、ntext 和 image 数据时，使用 8,040 字节的倍数的块区大小。

在 SQL Server 中，可能存在指向 text、ntext 或 image 数据的行内文本指针，但其可能无效。有关 text in row 选项的信息，请参阅 sp_tableoption (Transact-SQL)。有关使文本指针失效的信息，请参阅 sp_invalidate_textptr (Transact-SQL)。

若要将 text 列初始化为 NULL，请在兼容级别等于 65 时使用 UPDATETEXT。如果兼容级别等于 70，请使用 WRITETEXT 将文本列初始化为 NULL；否则，UPDATETEXT 会将 text 列初始化为空字符串。有关设置兼容级别的信息，请参阅 sp_dbcmptlevel (Transact-SQL)。

需要对指定表的 UPDATE 权限。

以下示例将文本指针放入局部变量 @ptrval 中，然后使用 UPDATETEXT 更新拼写错误。

注意：
若要运行此示例，必须安装 pubs 数据库。有关如何安装 pubs 数据库的信息，请参阅下载 Northwind 和 pubs 示例数据库。

USE pubs;
GO
ALTER DATABASE pubs SET RECOVERY SIMPLE;
GO
DECLARE @ptrval binary(16);
SELECT @ptrval = TEXTPTR(pr_info) 
   FROM pub_info pr, publishers p
      WHERE p.pub_id = pr.pub_id 
      AND p.pub_name = 'New Moon Books'
UPDATETEXT pub_info.pr_info @ptrval 88 1 'b';
GO
ALTER DATABASE pubs SET RECOVERY FULL;
GO

参考

其他资源

帮助和信息