Reference Manual
   CHAPTER 9. SQL Statements     

WRITETEXT statement [T-SQL]

Function 

Permits non-logged, interactive updating of an existing text or image column.

Syntax 

WRITETEXT table-name.column-name
... text_pointer [ WITH LOG ] data

Authorization 

None.

Side effects 

WRITETEXT does not fire triggers, and by default WRITETEXT operations are not recorded in the transaction log.

Description 

Updates an existing text or image value. The update is not recorded in the transaction log, unless the WITH LOG option is supplied. You cannot carry out WRITETEXT operations on views.

Standards and compatibility 

• SQL/92     Transact-SQL extension.

• Sybase     Supported by Adaptive Server Enterprise.

Example 

• The following code fragment illustrates the use of the WRITETEXT statement. The SELECT statement in this example returns a single row. The example replaces the contents of the column_name column on the specified row with the value newdata.

  EXEC SQL create variable textpointer binary(16);
  EXEC SQL set textpointer =
     (   select textptr(column_name) 
        from table_name where ... ) ;
  EXEC SQL writetext table_name.column_name
     textpointer 'newdata' ;