WRITETEXT (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 托管实例

允许对现有的 text、ntext 或 image 列执行最小日志记录的交互式更新。 WRITETEXT 将覆盖受其影响的列中的所有现有数据。 WRITETEXT 语句不能用于视图中的 text、ntext 或 image 列。

重要

在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。 改用大值数据类型和 UPDATE 语句的 .WRITE 子句。

Transact-SQL 语法约定

语法

WRITETEXT [BULK]  
  { table.column text_ptr }  
  [ WITH LOG ] { data }

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

参数

BULK
启用上载工具来上载二进制数据流。 该数据流必须由该工具在 TDS 协议级别提供。 在数据流不存在时，查询处理器将忽略 BULK 选项。

重要

我们建议不要在基于 SQL Server 的应用程序中使用 BULK 选项。 在 SQL Server 的未来版本中可能会更改或删除该选项。

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

text_ptr
存储指向 text、ntext 或 image 数据的指针的值。 text_ptr 必须是 binary(16)。若要创建文本指针，请对非 NULL 值的 text、ntext 或 image 列数据执行 INSERT 或 UPDATE 语句。

WITH LOG
被 SQL Server 忽略。 日志记录由数据库的当前恢复模式决定。

data
要存储的实际 text、ntext 或 image 数据。 data 可以是文字或参数。 对于 text、ntext 或 image 数据，可以使用 WRITETEXT 以交互方式插入的最大文本长度约为 120 KB。

备注

使用 WRITETEXT 替换 text、ntext 或 image 数据，使用 UPDATETEXT 修改 text、ntext 或 image 数据。 UPDATETEXT 更加灵活，因为它只更改 text、ntext 或 image 列的一部分而非整个列。

为获得最佳性能，建议按照块区大小为 8040 字节倍数的方式插入或更新 text、ntext 或 image 数据。

如果数据库为简单恢复模式或大容量日志恢复模式，则在插入或追加新数据时，使用 WRITETEXT 语句的 text、ntext 或 image 操作将成为最小日志记录操作。

注意

在更新现有值时，不使用最小日志记录。

为了正确使用 WRITETEXT，列必须已经包含有效的文本指针。

如果该表没有行内文本，则在通过 INSERT 向 text 列中添加显式或隐式 NULL 值时，SQL Server 不初始化 text 列以节省空间，并且不能获取这类 NULL 值的文本指针。 若要将 text 列初始化为 NULL，请使用 UPDATE 语句。 如果表有行内文本，则不必为空值初始化文本列，而且始终可以获取文本指针。

ODBC SQLPutData 函数更快，且使用的动态内存比 WRITETEXT 少。 该函数最多可插入 2 GB 的 text、ntext 或 image 数据。

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

权限

需要对指定表的 UPDATE 权限。 可在转移 UPDATE 权限时转移这些权限。

示例

以下示例将文本指针放到局部变量 @ptrval 中，然后 WRITETEXT 将新的文本字符串放到 @ptrval 指向的行中。

注意

若要运行此示例，必须安装 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'  
WRITETEXT pub_info.pr_info @ptrval 'New Moon Books (NMB) has just released another top ten publication. With the latest publication this makes NMB the hottest new publisher of the year!';  
GO  
ALTER DATABASE pubs SET RECOVERY SIMPLE;  
GO

另请参阅

数据类型 (Transact-SQL)
DECLARE @local_variable (Transact-SQL)
DELETE (Transact-SQL)
SELECT (Transact-SQL)
SET 语句 (Transact-SQL)
UPDATETEXT (Transact-SQL)