共用方式為


UPDATETEXT (Transact-SQL)

更新現有的 textntextimage 欄位。請利用 UDPATETEXT 來就地變更 textntextimage 資料行的一部份。請利用 WRITETEXT 來更新和取代整個 textntextimage 欄位。

ms189466.note(zh-tw,SQL.90).gif重要事項:
未來的 Microsoft SQL Server 發行版本將不再提供此功能。請避免在新的開發工作中使用此功能,並計劃修改目前使用此功能的應用程式。 請改用 UPDATE 陳述式的大數值資料類型和 .WRITE 子句。

主題連結圖示Transact-SQL 語法慣例

語法

UPDATETEXT { table_name.dest_column_name dest_text_ptr }
    { NULL | insert_offset }
     { NULL | delete_length }
     [ WITH LOG ]
     [ inserted_data
    | { table_name.src_column_name src_text_ptr } ]

引數

table_name**.**dest_column_name

這是要更新的資料表和 textntextimage 資料行的名稱。資料表名稱和資料行名稱必須符合識別碼的規則。資料庫名稱和擁有者名稱的指定是選擇性的。

dest_text_ptr

這是指向要更新的 textntextimage 資料的文字指標值 (TEXTPTR 函數所傳回)。dest_text_ptr 必須是 binary(16)

insert_offset

這是以零為基底的更新起始位置。如果是 textimage 資料行,insert_offset 是在插入新資料之前,從現有資料行起點跳過的位元組數。如果是 ntext 資料行,insert_offset 是字元數目 (每個 ntext 字元使用 2 位元組)。從這個以零為基底之起始位置開始的現有 textntextimage 資料,會向右位移來騰出新資料的空間。0 值會將新資料插入現有資料的起點。NULL 值會將新資料附加至現有的資料值。

delete_length

這是要從現有 textntextimage 資料行中刪除的資料長度,從 insert_offset 位置開始。textimage 資料行的 delete_length 值以位元組來指定,ntext 資料行的這個值以字元來指定。每個 ntext 字元都使用 2 位元組。0 值不會刪除任何資料。NULL 值會刪除從 insert_offset 位置到現有 textimage 資料行結尾的所有資料。

WITH LOG

在 SQL Server 2000 中,忽略這個項目。在 SQL Server 2005 中,記錄取決於資料庫的實際復原模式。

inserted_data

這是要在 insert_offset 位置插入現有 textntextimage 資料行的資料。這是單一 charncharvarcharnvarcharbinaryvarbinarytextntextimage 值。inserted_data 可以是常數或變數。

table_name.src_column_name

這是要作為插入資料來源所用的資料表和 textntextimage 資料行的名稱。資料表名稱和資料行名稱必須符合識別碼的規則。

src_text_ptr

這是指向要作為插入資料來源所用的 textntextimage 資料行的文字指標值 (TEXTPTR 函數所傳回)。

ms189466.note(zh-tw,SQL.90).gif附註:
scr_text_ptr 值不能與 dest_text_ptr 值相同。

備註

新插入的資料可以是單一 inserted_data 常數、資料表名稱、資料行名稱或文字指標。

更新動作 UPDATETEXT 參數

若要取代現有的資料

請指定非 Null 的 insert_offset 值、非零的 delete_length 值,以及要插入的新值。

若要刪除現有的資料

請指定非 Null insert_offset 值和非零的 delete_length。請勿指定要插入的新資料。

若要插入新的資料

請指定 insert_offset 值、delete_length 0,以及要插入的新資料。

若要有最佳效能,我們建議您以 8,040 位元組倍數的片段大小來插入或更新 textntextimage 資料。

在 SQL Server 中,指向 textntextimage 資料的同資料列文字指標有可能存在而無效。如需有關 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 來更新拼字錯誤。

ms189466.note(zh-tw,SQL.90).gif附註:
若要執行這個範例,您必須安裝 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

請參閱

參考

READTEXT (Transact-SQL)
TEXTPTR (Transact-SQL)
WRITETEXT (Transact-SQL)

其他資源

使用大數值資料類型

說明及資訊

取得 SQL Server 2005 協助