Text- und Bildfunktionen: TEXTVALID (Transact-SQL)

Artikel
10/16/2024

Gilt für: SQL Server Azure SQL Managed Instance

Eine text-, ntext- oder image-Funktion, die prüft, ob der angegebene Textzeiger gültig ist.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Es steht keine alternative Funktionalität zur Verfügung.

Transact-SQL-Syntaxkonventionen

Syntax

TEXTVALID ( 'table.column' ,text_ ptr )

Argumente

Tabelle
Der Name der zu verwendenden Tabelle

column
Der Name der zu verwendenden Spalte

text_ptr
Der zu prüfende Textzeiger

Rückgabetypen

int

Bemerkungen

Gibt 1 zurück, wenn der Zeiger gültig ist, oder 0, wenn er ungültig ist. Beachten Sie, dass der Bezeichner für die text-Spalte auch den Tabellennamen enthalten muss. Sie können UPDATETEXT, WRITETEXT oder READTEXT nicht ohne einen gültigen Textzeiger verwenden.

Die folgenden Funktionen und Anweisungen sind auch bei Daten vom Typ text, ntext oder image hilfreich.

Funktion oder Anweisung	BESCHREIBUNG
PATINDEX ( ' %pattern%* '* , expression )	Gibt die Zeichenposition einer angegebenen Zeichenfolge in Spalten vom Typ text oder ntext zurück.
DATALENGTH ( expression )	Gibt die Länge der Daten in den text-, ntext- und image-Spalten zurück.
SET TEXTSIZE	Gibt das Limit der text-, ntext- oder image-Daten, die von einer SELECT-Anweisung zurückgegeben werden sollen, in Byte zurück.

Beispiele

Im folgenden Beispiel wird gemeldet, ob für jeden Wert in der logo-Spalte der pub_info-Tabelle ein gültiger Textzeiger vorhanden ist.

Hinweis

Um dieses Beispiel auszuführen, müssen Sie die pubs-Datenbank installieren.

USE pubs;  
GO  
SELECT pub_id, 'Valid (if 1) Text data'   
   = TEXTVALID ('pub_info.logo', TEXTPTR(logo))   
FROM pub_info  
ORDER BY pub_id;  
GO

Hier sehen Sie das Ergebnis.

pub_id Valid (if 1) Text data   
------ ----------------------   
0736   1                        
0877   1                        
1389   1                        
1622   1                        
1756   1                        
9901   1                        
9952   1                        
9999   1                        
  
(8 row(s) affected)

Weitere Informationen

DATALENGTH (Transact-SQL)
PATINDEX (Transact-SQL)
SET TEXTSIZE (Transact-SQL)
Text- und Bildfunktionen (Transact-SQL)
TEXTPTR (Transact-SQL)

Teilen über