Compartilhar via


TEXTPTR (Transact-SQL)

Retorna o valor do ponteiro de texto que corresponde a uma coluna text, ntextou image no formato varbinary. O valor do ponteiro de texto recuperado pode ser usado nas instruções READTEXT, WRITETEXT e UPDATETEXT.

Observação importanteImportante

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. A funcionalidade alternativa não está disponível.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

TEXTPTR ( column )

Argumentos

  • column
    É a coluna text, ntextou image que será usada.

Tipos de retorno

varbinary

Comentários

Na SQL Server 2005 e em versões posteriores, para tabelas com texto em linha, TEXTPTR retorna um identificador para que o texto seja processado. É possível obter um ponteiro de texto válido mesmo que o valor de texto seja nulo.

Na SQL Server 2005 e em versões posteriores, não é possível usar a função TEXTPTR em colunas de exibições. Ela só pode ser usada em colunas de tabelas. Para usar a função TEXTPTR em uma coluna de uma exibição, é necessário definir o nível de compatibilidade como 80, usando Nível de compatibilidade ALTER DATABASE. Se a tabela não tiver um texto em linha, e se uma coluna text, ntext ou image não foi inicializada por uma instrução UPDATETEXT, TEXTPTR retornará um ponteiro nulo.

Use TEXTVALID para testar se um ponteiro de texto existe. Não é possível usar UPDATETEXT, WRITETEXT ou READTEXT sem um ponteiro de texto válido.

Estas funções e instruções também são úteis para trabalhar com text, ntexte dados image.

Função ou instrução

Descrição

PATINDEX('%pattern%' , expression)

Retorna a posição de caracteres de uma cadeia de caracteres especificada nas colunas text ou ntext.

DATALENGTH(expression)

Retorna o comprimento de dados nas colunas text, ntexte image.

SET TEXTSIZE

Retorna o limite, em bytes, dos dados text, ntextou image a serem retornados com uma instrução SELECT.

SUBSTRING(text_column, start, length)

Retorna uma cadeia de caracteres varchar especificada pelo deslocamento start especificado e length. O comprimento deve ser menor que 8 KB.

Exemplos

ObservaçãoObservação

Para executar os exemplos a seguir, é necessário instalar o banco de dados pubs. Para obter informações sobre como instalar o banco de dados pubs, consulte Baixando os bancos de dados de exemplo Northwind e pubs.

A. Usando TEXTPTR

O exemplo a seguir usa a função TEXTPTR para localizar a coluna imagelogoassociada a New Moon Books na tabela pub_info do banco de dados pubs. O ponteiro de texto é colocado em uma variável 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. Usando TEXTPTR com texto em linha

No SQL Server, o ponteiro de texto em linha deve ser usado dentro de uma transação, como mostra o exemplo a seguir.

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. Retornando dados de texto

O exemplo a seguir seleciona a coluna pub_id e o ponteiro de texto de 16 bytes da coluna pr_info na tabela pub_info.

USE pubs
GO
SELECT pub_id, TEXTPTR(pr_info)
FROM pub_info
ORDER BY pub_id
GO

Conjunto de resultados.

pub_id                                    
------ ---------------------------------- 
0736   0x6c0000000000feffb801000001000100 
0877   0x6d0000000000feffb801000001000300 
1389   0x6e0000000000feffb801000001000500 
1622   0x700000000000feffb801000001000900 
1756   0x710000000000feffb801000001000b00 
9901   0x720000000000feffb801000001000d00 
9952   0x6f0000000000feffb801000001000700 
9999   0x730000000000feffb801000001000f00 

(8 row(s) affected)

O exemplo a seguir mostra como retornar os primeiros 8000 bytes de texto sem usar TEXTPTR.

USE pubs
GO
SET TEXTSIZE 8000
SELECT pub_id, pr_info
FROM pub_info
ORDER BY pub_id
GO

Conjunto de resultados.

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. Retornando dados de texto específicos

O exemplo a seguir localiza a coluna text (pr_info) associada a pub_id0736 na tabela pub_info do banco de dados pubs. Primeiro, ele declara a variável local @val. O ponteiro de texto (uma longa cadeia de caracteres binários) é colocado em @val e fornecido como parâmetro para a instrução READTEXT. Isto retorna 10 bytes, iniciando no quinto byte (deslocamento de 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

Conjunto de resultados.

pr_info                                                                                                                                                                                                                                                         
-----------------------------------------------------------------------
 is sample
(1 row(s) affected)