UPDATETEXT (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

Actualiza un campo text, ntext o image existente. Use UPDATETEXT para cambiar solo una parte de una columna text, ntext o image existente. Use WRITETEXT para actualizar y reemplazar un campo text, ntext o image completo.

Convenciones de sintaxis de Transact-SQL

Sintaxis

UPDATETEXT [BULK] { 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 } ]  

Argumentos

BULK
Hace posible que las herramientas de carga carguen flujos de datos binarios. La herramienta debe proporcionar flujos en el nivel de protocolo TDS. Cuando el flujo de datos no esté presente el procesador de consultas omite la opción BULK.

table_name.dest_column_name
Es el nombre de la tabla y la columna text, ntext o image que se van a actualizar. Los nombres de las tablas y de las columnas deben cumplir las reglas de los identificadores. La especificación de los nombres de la base de datos y del propietario es opcional.

dest_text_ptr
Es el valor de un puntero de texto (devuelto por la función TEXTPTR) que señala a los datos text, ntext o image que se van a actualizar. dest_text_ptr debe ser binary(16).

insert_offset
Es la posición de inicio de la actualización a partir de cero. En columnas text o image, insert_offset es el número de bytes que se van a omitir desde el principio de la columna existente antes de insertar nuevos datos. En columnas ntext, insert_offset es el número de caracteres (cada carácter ntext usa dos bytes). Los datos text, ntext o image existentes a partir de esta posición de inicio basada en cero se desplazan a la derecha para dejar espacio a los nuevos datos. Un valor 0 inserta los nuevos datos al principio de los datos existentes. Un valor NULL anexa los nuevos datos al valor de datos existente.

delete_length
Es la longitud de los datos que se van a eliminar de la columna text, ntext o image existente, a partir de la posición de insert_offset. El valor delete_length se expresa en bytes en las columnas text e image y en caracteres en las columnas ntext. Cada carácter ntext usa dos bytes. Con un valor 0 no se eliminan datos. Con un valor NULL, se eliminan todos los datos desde la posición de insert_offset hasta el final de la columna text o image existente.

WITH LOG
El registro está determinado por el modelo de recuperación vigente para la base de datos.

inserted_data
Son los datos que se van a insertar en la columna text, ntext o image existente en la posición de insert_offset. Se trata de un solo valor char, nchar, varchar, nvarchar, binary, varbinary, text, ntext o image. inserted_data puede ser un literal o una variable.

table_name.src_column_name
Es el nombre de la tabla y de la columna text, ntext o image que se van a usar como origen de los datos insertados. Los nombres de las tablas y de las columnas se deben ajustar a las reglas para los identificadores.

src_text_ptr
Es un valor de puntero de texto (devuelto por la función TEXTPTR) que señala a una columna text, ntext o image usada como origen de los datos insertados.

Comentarios

Los datos recién insertados pueden ser una única constante inserted_data, un nombre de tabla, un nombre de columna o un puntero de texto.

Para mejorar el rendimiento, se recomienda insertar o actualizar los datos text, ntext e image en fragmentos que sean múltiplos de 8.040 bytes.

En SQL Server, es posible que existan punteros de texto de fila a datos de tipo text, ntext o image, pero que no sean válidos. Para obtener más información sobre la opción "text in row", vea sp_tableoption (Transact-SQL). Para obtener más información sobre cómo invalidar punteros de texto, vea sp_invalidate_textptr (Transact-SQL).

Para inicializar columnas text en NULL, use WRITETEXT; UPDATETEXT inicializa columnas text en una cadena vacía.

Permisos

Requiere el permiso UPDATE en la base de datos especificada.

Ejemplos

En el ejemplo siguiente se coloca el puntero de texto en la variable local @ptrval; a continuación, se utiliza UPDATETEXT para actualizar un error de ortografía.

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  

Vea también

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