Fonctions texte et image - TEXTPTR (Transact-SQL)

S’applique à : ouiSQL Server (toutes les versions prises en charge) OuiAzure SQL Managed Instance

Retourne la valeur du pointeur de texte qui correspond à une colonne de type text, ntext ou image au format varbinary. La valeur du pointeur de texte obtenue peut être utilisée dans les instructions READTEXT, WRITETEXT et UPDATETEXT.

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Aucune fonctionnalité de remplacement n'est disponible.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

TEXTPTR ( column )  

Notes

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 et versions antérieures, consultez Versions antérieures de la documentation.

Arguments

column
Colonne text, ntext ou image qui sera utilisée.

Types de retour

varbinary

Notes

Pour les tables avec du texte en ligne, TEXTPTR renvoie un descripteur pour le texte à traiter. Vous pouvez obtenir un pointeur de texte valide même lorsque la valeur du texte est nulle.

Vous ne pouvez pas utiliser la fonction TEXTPTR sur des colonnes de vues. Vous ne pouvez l'utiliser que sur des colonnes de tables. Pour utiliser la fonction TEXTPTR sur une colonne de vue, vous devez spécifier un niveau de compatibilité égal à 80 à l’aide du niveau de compatibilité ALTER DATABASE. Si la table ne possède pas de texte en ligne et si aucune colonne text, ntext ni image n’a été initialisée par une instruction UPDATETEXT, la fonction TEXTPTR retourne un pointeur null.

Utilisez TEXTVALID pour vérifier l'existence d'un pointeur de texte. Vous ne pouvez pas utiliser UPDATETEXT, WRITETEXT ou READTEXT sans pointeur de texte valide.

Ces fonctions et instructions sont également utiles lorsque vous travaillez avec des données text, ntext et image.

Fonction ou instruction Description
PATINDEX (' %pattern% ' , expression ) Retourne la position d’un caractère dans la chaîne de caractères spécifiée dans les colonnes text et ntext.
DATALENGTH (expression ) Retourne la longueur des données dans les colonnes de type text, ntext et image.
SET TEXTSIZE Retourne la limite, en octets, des données text, ntext ou image à retourner avec une instruction SELECT.
SUBSTRING (text_column, start, length ) Retourne une chaîne varchar spécifiée par le décalage start et par la longueur length. La longueur doit être inférieure à 8 Ko.

Exemples

Notes

Pour exécuter les exemples suivants, vous devez installer la base de données pubs.

R. Utilisation de TEXTPTR

L’exemple qui suit utilise la fonction TEXTPTR pour rechercher le logo de la colonne image associé à New Moon Books dans la table pub_info de la base de données pubs. Le pointeur de texte identifie la variable locale @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. Utilisation de TEXTPTR avec du texte dans la ligne

Dans SQL Server, le pointeur de texte dans la ligne doit être utilisé au sein d'une transaction, comme le montre l'exemple suivant.

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. Renvoi des données texte

Cet exemple sélectionne la colonne pub_id et le pointeur de texte sur 16 octets de la colonne pr_info dans la table pub_info.

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

Voici le jeu de résultats obtenu.

pub_id                                      
------ ----------------------------------   
0736   0x6c0000000000feffb801000001000100   
0877   0x6d0000000000feffb801000001000300   
1389   0x6e0000000000feffb801000001000500   
1622   0x700000000000feffb801000001000900   
1756   0x710000000000feffb801000001000b00   
9901   0x720000000000feffb801000001000d00   
9952   0x6f0000000000feffb801000001000700   
9999   0x730000000000feffb801000001000f00   
  
(8 row(s) affected)  

Cet exemple indique comment retourner les 8000 premiers octets de texte sans utiliser TEXTPTR.

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

Voici le jeu de résultats obtenu.

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. Renvoi des données texte spécifiques

L’exemple qui suit localise la colonne text (pr_info) associée à pub_id``0736 dans la table pub_info de la base de données pubs. Elle commence par déclarer la variable locale @val. Le pointeur de texte (une chaîne binaire de type long) est ensuite placé dans @val, puis passé comme paramètre à l'instruction READTEXT. Cette opération renvoie 10 octets à partir du cinquième octet (décalage de 4 octets).

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  

Voici le jeu de résultats obtenu.

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

Voir aussi

DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL)
READTEXT (Transact-SQL)
SET TEXTSIZE (Transact-SQL)
Fonctions texte et image (Transact-SQL)
UPDATETEXT (Transact-SQL)
WRITETEXT (Transact-SQL)