TEXTPTR (Transact-SQL)
Devuelve el valor del puntero de texto que corresponde a una columna text, ntext o image en formato varbinary. El valor del puntero de texto devuelto se puede utilizar en las instrucciones READTEXT, WRITETEXT y UPDATE.
.gif "Nota importante") Importante |
|---|
Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. No existe ninguna funcionalidad alternativa. |
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
TEXTPTR ( column )
Argumentos
- column
Es la columna de tipo text, ntext o image que se va a utilizar.
Tipos de valor devueltos
varbinary
Comentarios
En SQL Server 2005 y versiones posteriores, en las tablas con texto consecutivo, TEXTPTR devuelve un controlador para el texto que se va a procesar. Es posible obtener un puntero de texto válido aunque el valor del texto sea NULL.
En SQL Server 2005 y versiones posteriores, la función TEXTPTR no se puede utilizar en columnas de vistas. Solo se puede utilizar en columnas de tablas. Para utilizar la función TEXTPTR en una columna de una vista, debe establecerse el nivel de compatibilidad en 80 mediante el nivel de compatibilidad de ALTER DATABASE. Si la tabla no dispone de texto consecutivo y la instrucción UPDATETEXT no ha inicializado una columna text, ntext o image, TEXTPTR devuelve un puntero NULL.
Utilice TEXTVALID para comprobar si un puntero de texto existe. No puede utilizarse UPDATETEXT, WRITETEXT o READTEXT sin un puntero de texto valido.
Estas funciones e instrucciones son también útiles cuando se trabaja con datos de tipo text, ntext e image.
Función o instrucción |
Descripción |
|---|---|
PATINDEX('%pattern%' , expression) |
Devuelve la posición de carácter de una cadena de caracteres especificada en columnas de tipo text o ntext. |
DATALENGTH(expression) |
Devuelve la longitud de los datos de las columnas de tipo text, ntext e image. |
SET TEXTSIZE |
Devuelve el límite, en bytes, de los datos de tipo text, ntext o image que se devuelven con una instrucción SELECT. |
SUBSTRING(text_column, start, length) |
Devuelve una cadena de tipo varchar según los valores especificados en el desplazamiento start y length. La longitud debe ser inferior a 8 KB. |
Ejemplos
[!NOTA]
Para ejecutar los siguientes ejemplos, es necesario instalar la base de datos pubs.
A.Usar TEXTPTR
En el ejemplo siguiente se utiliza la función TEXTPTR para encontrar la columna de tipo image logo asociada a New Moon Books en la tabla pub_info de la base de datos pubs. El puntero de texto se coloca en la variable local @ptrval.
USE pubs
GO
DECLARE @ptrval varbinary(16)
SELECT @ptrval = TEXTPTR(logo)
FROM pub_info pr, publishers p
WHERE p.pub_id = pr.pub_id
AND p.pub_name = 'New Moon Books'
GO
B.Usar TEXTPTR con texto consecutivo
En SQL Server, el puntero de texto consecutivo debe utilizarse dentro de una transacción, como se muestra en el ejemplo siguiente.
CREATE TABLE t1 (c1 int, c2 text)
EXEC sp_tableoption 't1', 'text in row', 'on'
INSERT t1 VALUES ('1', 'This is text.')
GO
BEGIN TRAN
DECLARE @ptrval VARBINARY(16)
SELECT @ptrval = TEXTPTR(c2)
FROM t1
WHERE c1 = 1
READTEXT t1.c2 @ptrval 0 1
COMMIT
C.Devolver datos de texto
En el ejemplo siguiente se seleccionan la columna pub_id y el puntero de texto de 16 bits de la columna pr_info de la tabla pub_info.
USE pubs
GO
SELECT pub_id, TEXTPTR(pr_info)
FROM pub_info
ORDER BY pub_id
GO
El conjunto de resultados es el siguiente.
pub_id
------ ----------------------------------
0736 0x6c0000000000feffb801000001000100
0877 0x6d0000000000feffb801000001000300
1389 0x6e0000000000feffb801000001000500
1622 0x700000000000feffb801000001000900
1756 0x710000000000feffb801000001000b00
9901 0x720000000000feffb801000001000d00
9952 0x6f0000000000feffb801000001000700
9999 0x730000000000feffb801000001000f00
(8 row(s) affected)
En el ejemplo siguiente se muestra cómo devolver los primeros 8000 bytes de texto sin utilizar TEXTPTR.
USE pubs
GO
SET TEXTSIZE 8000
SELECT pub_id, pr_info
FROM pub_info
ORDER BY pub_id
GO
El conjunto de resultados es el siguiente.
pub_id pr_info
------ -----------------------------------------------------------------
0736 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!
0877 This is sample text data for Binnet & Hardley, publisher 0877 in the pubs database. Binnet & Hardley is located in Washington, D.C.
This is sample text data for Binnet & Hardley, publisher 0877 in the pubs database. Binnet & Hardley is located in Washi
1389 This is sample text data for Algodata Infosystems, publisher 1389 in the pubs database. Algodata Infosystems is located in Berkeley, California.
9999 This is sample text data for Lucerne Publishing, publisher 9999 in the pubs database. Lucerne publishing is located in Paris, France.
This is sample text data for Lucerne Publishing, publisher 9999 in the pubs database. Lucerne publishing is located in
(8 row(s) affected)
D.Devolver datos de texto específicos
En el ejemplo siguiente se encuentra la columna de tipo text (pr_info) asociada a pub_id 0736 en la tabla pub_info de la base de datos pubs. Primero se declara la variable local @val. A continuación, el puntero de texto (una cadena binaria de tipo long) se coloca en @val y se suministra como parámetro a la instrucción READTEXT. De esta forma, se devuelven 10 bytes a partir del quinto byte (el desplazamiento es 4).
USE pubs
GO
DECLARE @val varbinary(16)
SELECT @val = TEXTPTR(pr_info)
FROM pub_info
WHERE pub_id = '0736'
READTEXT pub_info.pr_info @val 4 10
GO
El conjunto de resultados es el siguiente.
pr_info
-----------------------------------------------------------------------
is sample
(1 row(s) affected)