WRITETEXT (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL Managed Instance

Lehetővé teszi egy meglévő szöveg, ntext vagy képoszlop minimálisan naplózott, interaktív frissítését. A WRITETEXT felülírja az általa érintett oszlopban lévő meglévő adatokat. A WRITETEXT nem használható szöveg-, ntext- és képoszlopokon a nézetekben.

Important

Ez a funkció a SQL Server egy későbbi verziójában lesz eltávolítva. Ne használja ezt a funkciót az új fejlesztési munkában, és tervezze meg a funkciót jelenleg használó alkalmazások módosítását. Használd a nagy értékű adattípusokat és a . Helyette ÍRJ a kijelentés szövegét UPDATE .

Transact-SQL szintaxis konvenciók

Syntax

WRITETEXT [BULK]  
  { table.column text_ptr }  
  [ WITH LOG ] { data }  

Arguments

TERJEDELEM
Lehetővé teszi a feltöltési eszközök számára, hogy bináris adatfolyamot töltsenek fel. Az adatfolyamot az eszköznek a TDS protokoll szintjén kell biztosítania. Ha az adatfolyam nincs jelen, a lekérdezésfeldolgozó figyelmen kívül hagyja a BULK opciót.

Important

Javasoljuk, hogy a BULK opciót ne használják SQL Server-alapú alkalmazásokban. Ez az opció egy későbbi SQL Server verzióban megváltozhat vagy eltávolítható.

table.oszlop
A tábla és a szöveg, ntext vagy képoszlop neve, amit frissíteni kell. A táblázat- és oszlopneveknek megfelelniük kell az azonosítók szabályainak. Az adatbázis és tulajdonos neveinek megadása opcionális.

text_ptr
Ez egy olyan érték, amely tárolja a mutatót a szövegre, ntext vagy kép adatokra. text_ptrbinárisnak kell lennie(16). Szövegmutató létrehozásához hajtson végre egy INSERT vagy UPDATE utasítást olyan adattal, amely nem null a szöveg, ntext vagy kép oszlopban.

NAPLÓVAL
Az SQL Server figyelmen kívül hagyta. A naplózást az adatbázis működésében lévő helyreállítási modell határozza meg.

adat
A tényleges szöveg, ntext vagy kép adatot kell tárolni? Az adat lehet literális vagy paraméter. A WRITETEXT interaktívan beilleszthető maximális szöveghossza körülbelül 120 KB szöveg, ntext és kép adatokhoz.

Remarks

Használd a WRITETEXT billentyűt a szöveg, ntext és kép adatok cseréjére, a UPDATETEXT segítségével pedig módosítsd a szöveget, ntext és kép adatait. Az UPDATETEXT rugalmasabb, mert csak egy szöveg, ntext vagy képoszlop egy részét változtatja meg, nem pedig az egész oszlopot.

A legjobb teljesítmény érdekében javasoljuk, hogy a szöveg, ntext és kép adatokat 8040 bájt többszörös tömbméretűségében helyezzük be vagy frissítsék.

Ha az adatbázis-helyreállítási modell egyszerű vagy tömegesen naplózott, akkor a WRITETEXT-et használó szöveg-, ntext és kép műveletek minimálisan naplózott műveletek, amikor új adatokat illesztenek be vagy csatolnak.

Note

Minimális naplózást nem használnak a meglévő értékek frissítésekor.

Ahhoz, hogy a WRITETEXT helyesen működjön, az oszlopnak már tartalmaznia kell egy érvényes szövegmutatót.

Ha a táblázatban nincs sorbeli szöveg, az SQL Server helyet takarít meg azzal, hogy nem inicializálja a szövegoszlopokat, amikor explicit vagy implicit nullértékeket adnak hozzá a szövegoszlopokban, amelyekkel INSERT, és ilyen nullákhoz nem lehet szövegmutatót szerezni. A szövegoszlopok NULL-ra inicializálásához használja az utasítást UPDATE . Ha a táblázatban soron belüli szöveg van, nem kell inicializálni a szövegoszlopot nullokhoz, és mindig kaphatsz szövegmutatót.

Az ODBC SQLPutData funkció gyorsabb, és kevesebb dinamikus memóriát használ, mint a WRITETEXT. Ez a funkció akár 2 gigabájt szöveg-, ntext- vagy képadatot is beilleszthet.

Az SQL Server-ben sorbeli szövegmutatók lehetnek szöveg-, ntext- vagy képadatokra mutatva, de nem feltétlenül érvényesek. A szöveg sorban opcióval kapcsolatos információkért lásd a sp_tableoption (Transact-SQL). A szöveges mutatók érvénytelenítéséről információért lásd a sp_invalidate_textptr (Transact-SQL) oldalt.

Permissions

Engedély UPDATE szükséges a megadott táblán. Az engedély átruházható, amikor UPDATE az engedély átkerül.

Examples

A következő példa a szövegmutatót a helyi változóba @ptrvalhelyezi, majd WRITETEXT az új szövegláncot a sorba helyezi, amelyre mutat.@ptrval

Note

A példához telepítened kell a pubs mintaadatbázist.

USE pubs;  
GO  
ALTER DATABASE pubs SET RECOVERY SIMPLE;  
GO  
DECLARE @ptrval BINARY(16);  
SELECT @ptrval = TEXTPTR(pr_info)   
FROM pub_info pr, publishers p  
WHERE p.pub_id = pr.pub_id   
   AND p.pub_name = 'New Moon Books'  
WRITETEXT pub_info.pr_info @ptrval '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!';  
GO  
ALTER DATABASE pubs SET RECOVERY SIMPLE;  
GO  

Lásd még

Adattípusok (Transact-SQL)
DECLARE @local_variable (Transact-SQL)
DELETE (Transact-SQL)
VÁLASZT (Transact-SQL)
SET Utasítások (Transact-SQL)
FRISSÍTÉSSZÖVEG (Transact-SQL)