Aracılığıyla paylaş

  • Makale

WRITETEXT (Transact-SQL)

Varolan bir en az bir oturum, etkileşimli güncelleştirme izin verir. text, ntext, veya image sütun. Herhangi bir varolan verilerde WRITETEXT yazar sütun bu etkiler.Üzerinde WRITETEXT kullanılamaz. text, ntext, ve image görünümlerdeki sütunlar.

Important noteImportant Note:

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Büyük değer veri türleri'ni kullanın ve . yan tümce WRITE GÜNCELLEŞTİRME deyim yerine.

Topic link iconTransact-SQL sözdizimi kuralları

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

Bağımsız değişkenler

  • table**.**column
    Adı tablo ve text, ntext, veya image sütun güncelleştirmek için. Tablo ve sütun adları için kurallara uymanız gerekir tanımlayıcılar.Sahibinin adı ve veritabanı adını belirten isteğe bağlıdır.

  • text_ptr
    Is a value that stores the pointer to the text, ntext, or image data.text_ptr must be binary(16).To create a text pointer, execute an INSERT or UPDATE statement with data that is not null for the text, ntext, or image column.

  • GÜNLÜK İLE
    Tarafından yok sayılır. SQL Server. Günlük, geçerli veritabanının kurtarma modeli tarafından belirlenir.

  • data
    Is the actual text, ntext or image data to store.data can be a literal or a parameter.Etkileşimli WRITETEXT ile eklediğiniz metnin uzunluğu en fazla yaklaşık 120 KB olabilir... text, ntext, ve image veri.

Remarks

WRITETEXT değiştirmek için kullanın text, ntext, ve image veri ve UPDATETEXT değiştirmek için text, ntext, ve image veri. Yalnızca bir bölümünü değiştiğinden UPDATETEXT daha esnektir bir text, ntext, veya image sütunun tamamını yerine sütun.

En iyi performans için önerilir text, ntext, ve image veri eklendiğinde veya katları 8040 bayt öbek boyutları güncelleştirildi.

Veritabanı kurtarma modeli veya toplu oturum ise text, ntext, ve image Yeni veri eklenen veya eklenen WRITETEXT kullanan operasyonlar en az oturum operasyonlardır. Daha fazla bilgi için bkz:En az oturum işlemleri.

Not

Varolan değerleri güncelleştirildiği en az bir günlük kaydı kullanılır.

Düzgün çalışabilmesi WRITETEXT için sütun zaten işaretçisi geçerli bir metin içermelidir.

Satır metni, tabloyu yoksa SQL Server alan değil başlatarak kaydeder. text açık veya örtülü null değerleri eklendiğinde sütunlar text Ekle ve hiçbir metin işaretçisi içeren sütunlar için tür null elde edilebilir. Başlatılamadı text sütuna NULL, UPDATE deyimini kullanın. Tablo satır metin, metin sütun için bir boşluk atamanız gerekir ve her zaman bir metin işaretçisi alabilirsiniz.

ODBC SQLPutData işlev daha hızlıdır ve daha az dinamik WRITETEXT bellek kullanır.Bu işlev, en fazla 2 gigabayt ekleyebilirsiniz. text, ntext, veya image veri.

Içinde SQL Server, satır metin işaretçiler, text, ntext, veya image veri bulunabilir, ancak geçerli olmayabilir. Hakkında bilgi için Satır metni Bkz: seçeneğisp_tableoption (Transact-SQL). Metin işaretçisi geçersiz duruma getirmelerini hakkında daha fazla bilgi için bkz: sp_invalidate_textptr (Transact-SQL).

İzinler

Belirtilen tablo GÜNCELLEŞTIR izni gerektirir.UPDATE izni Transfer edildiğinde transfer edilebilir izindir.

Örnekler

Aşağıdaki örnek, yerel bir değişken metin işaretçisi koyar @ptrvalve sonra WRITETEXT Yeni metni koyar dize tarafından işaret satıra @ptrval.

Not

Bu örnek çalıştırmak için , yüklemeniz gereken Pubs örnek veritabanı.Nasıl yükleneceği hakkında bilgi için Pubs Bkz: örnek veritabanı,Northwind ve pubs örnek veritabanları karşıdan yükleniyor.

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