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.
.gif "Observação importante") Importante |
|---|
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. |
.gif "Ícone de vínculo de tópico")
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
.gif "Observação") Observaçã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)