METIN YAZ (Transact-SQL)

Şunlar için geçerlidir: SQL Server Azure SQL Yönetilen Örneği

Mevcut metin, ntext veya görsel sütununun minimum kayıtlı ve etkileşimli güncellenmesine izin verir. WRITETEXT, etkilediği sütundaki mevcut verileri üzerine yazar. WRITETEXT, görünümlerdeki metin, ntext ve resim sütunlarında kullanılamaz.

Important

Bu özellik, SQL Server'ın gelecek bir sürümünde kaldırılacaktır. Bu özelliği yeni geliştirme çalışmalarında kullanmaktan kaçının ve şu anda bu özelliği kullanan uygulamaları değiştirmeyi planlayın. Büyük değerli veri tiplerini ve . Bunun yerine ifadenin UPDATE WRITE cümlesini yazın.

Transact-SQL söz dizimi kuralları

Syntax

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

Arguments

YIĞIN
Yükleme araçlarının ikili veri akışı yüklemesini sağlar. Akış, araç tarafından TDS protokol seviyesinde sağlanmalıdır. Veri akışı yoksa, sorgu işlemcisi BULK seçeneğini görmezden gelir.

Important

BULK seçeneğinin SQL Server tabanlı uygulamalarda kullanılmamasını öneririz. Bu seçenek, gelecekteki bir SQL Server sürümünde değiştirilebilir veya kaldırılabilir.

table.column
Güncellenecek tablo ve metin, ntext veya resim sütununun adı. Tablo ve sütun adları, tanımlayıcı kurallarına uygun olmalıdır. Veritabanı adı ve sahibi adlarını belirtmek isteğe bağlıdır.

text_ptr
Metin, ntext veya resim verisine işaret noktasını saklayan bir değerdir. text_ptrikili olmalı(16). Metin işaretçisi oluşturmak için, metin, ntext veya resim sütunu için null olmayan verilerle bir INSERT or UPDATE ifadesi çalıştırın.

LOG İLE
SQL Server tarafından görmezden gelindi. Kayıt, veritabanı için geçerli olan kurtarma modeli tarafından belirlenir.

data
Gerçek metin, ntext veya resim verisi depolanacak mı? Veri literal veya parametre olabilir. WRITETEXT ile etkileşimli olarak eklenebilecek maksimum metin uzunluğu yaklaşık 120 KB'dir; metin, ntext ve görüntü verisi için.

Remarks

Metin, ntext ve görüntü verilerini değiştirmek için WRITETEXT ile ve metin, ntext ve görüntü verilerini değiştirmek için UPDATETEXT kullanın. UPDATETEXT daha esnektir çünkü tüm sütunu yerine metin,ntext veya resim sütununun sadece bir kısmını değiştirir.

En iyi performans için metin, ntext ve görüntü verilerinin 8040 baytın katı olan bölek boyutlarında eklenmesini veya güncellenmesini öneriyoruz.

Veritabanı kurtarma modeli basit veya toplu kayıtlıysa, WRITETEXT kullanan metin, ntext ve görüntü işlemleri, yeni veri eklendiğinde veya eklendiğinde minimum kayıtlı işlemler olarak görülür.

Note

Mevcut değerler güncellendiğinde minimum kayıt kullanılmaz.

WRITETEXT'in doğru çalışması için, sütunun zaten geçerli bir metin işaretçisi içermesi gerekir.

Tabloda satır içi metin yoksa, SQL Server, metin sütunlarındaINSERTaçık veya örtük null değerler eklendiğinde metin sütunlarını başlatmadığı için alan tasarrufu sağlar ve bu tür boş değerler için metin işaretçisi elde edilemez. Metin sütunlarını NULL olarak başlatmak için şu UPDATE ifadeyi kullanın. Tabloda satır içi metin varsa, nulllar için metin sütununu başlatmanıza gerek yoktur ve her zaman bir metin işaretçisi alabilirsiniz.

ODBC SQLPutData fonksiyonu daha hızlıdır ve WRITETEXT'e göre daha az dinamik bellek kullanır. Bu fonksiyon, en fazla 2 gigabayt metin, ntext veya görüntü verisi ekleyebilir.

SQL Server'da, satır içindeki metin göstergeleri metin, ntext veya görüntü verisine olabilir ancak geçerli olmayabilir. Metin satır içindeki seçeneği hakkında bilgi için sp_tableoption (Transact-SQL) bölümüne bakınız. Metin işaretçilerinin geçersiz kılılması hakkında bilgi için bkz. sp_invalidate_textptr (Transact-SQL) bölümünü ziyaret edin.

Permissions

Belirlenen tabloda izin gereklidir UPDATE . İzin devredildiğinde UPDATE izin devredilebilir.

Examples

Aşağıdaki örnek, metin işaretçisini yerel değişkene @ptrvalyerleştirir ve WRITETEXT ardından yeni metin dizisini işaret @ptrvaledilen satıra yerleştirir.

Note

Bu örneği çalıştırmak için yayın örnek veritabanını kurmanız gerekir.

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

Ayrıca Bkz.

Veri Türleri (Transact-SQL)
DECLARE @local_variable (Transact-SQL)
DELETE (Transact-SQL)
SEÇ (Transact-SQL)
SET İfadeler (Transact-SQL)
GÜNCELLEME METNI (Transact-SQL)

  • Last updated on