GÜNCELLEME METNI (Transact-SQL)

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

Mevcut bir metin, ntext veya resim alanını günceller. UPDATETEXT kullanarak metin,ntext veya resim sütununun sadece bir kısmını yerinde değiştirin. Tüm metin, ntext veya resim alanını güncellemek ve değiştirmek için WRITETEXT kullanın.

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

UPDATETEXT [BULK] { table_name.dest_column_name dest_text_ptr }  
  { NULL | insert_offset }  
     { NULL | delete_length }  
     [ WITH LOG ]  
     [ inserted_data  
    | { table_name.src_column_name src_text_ptr } ]

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_name.dest_column_name
Güncellenecek tablo ve metin, ntext veya resim sütununun adı mı? Tablo adları 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.

dest_text_ptr
Metin , güncellenecek metin, ntext veya görüntü verilerine işaret eden (TEXTPTR fonksiyonu tarafından döndürülen) bir metin işaretçisi değeridir. dest_text_ptrikili olmalı(16).

insert_offset
Güncelleme için sıfır tabanlı başlangıç pozisyonu. Metin veya görsel sütunları için, insert_offset, yeni veri eklemeden önce mevcut sütunun başından atlanacak bayt sayısıdır. ntext sütunları için insert_offset, karakter sayısıdır (her ntext karakteri 2 bayt kullanır). Bu sıfır tabanlı başlangıç konumundan başlayan mevcut metin, ntext veya görüntü verileri, yeni veriler için yer açmak amacıyla sağa kaydırılır. 0 değeri, mevcut verinin başına yeni veriyi ekler. NULL değeri, mevcut veri değerine yeni veriyi ekler.

delete_length
Mevcut metin, ntext veya resim sütunundan silinecek verinin uzunluğu, insert_offset konumdan başlayarak. delete_lengthdeğeri, metin ve resim sütunları için bayt cinsinden, ntext sütunları için ise karakterlerle belirtilir. Her ntext karakteri 2 bayt kullanır. 0 değeri veri silmesi anlamına gelir. NULL değeri, mevcut metin veya resim sütununun sonuna kadar olan insert_offset konumundan tüm verileri siler.

LOG İLE
Kayıt, veritabanı için geçerli olan kurtarma modeli tarafından belirlenir.

inserted_data
Veri, insert_offset konumundaki mevcut metin, ntext veya resim sütununa mı eklenecek? Bu, tek bir karakter, nchar, varchar, nvarchar, ikili, varbinary, metin, ntext veya görüntü değeridir. inserted_data kelime anlamı ya da değişken olabilir.

table_name.src_column_name
Eklenen verinin kaynağı olarak kullanılan tablo ve metin, ntext veya resim sütununun adı. Tablo adları ve sütun adları, tanımlayıcı kurallarına uygun olmalıdır.

src_text_ptr
Metin işaretçisi değeridir (TEXTPTR fonksiyonu tarafından döndürülür) ve eklenen verinin kaynağı olarak kullanılan bir metin, ntext veya resim sütununa işaret eder.

Uyarı

scr_text_ptr değer, dest_text_ptrdeğerle aynı olmamalıdır.

Remarks

Yeni eklenen veriler tek bir inserted_data sabiti, tablo adı, sütun adı veya metin işaretçisi olabilir.

Güncelleştirme eylemi UPDATETEXT parametreleri
Mevcut verileri değiştirmek için Sıfır olmayan bir insert_offset değeri, sıfır olmayan bir delete_length değeri ve eklenecek yeni veri belirtin.
Mevcut verileri silmek için Null olmayan bir insert_offset değeri ve sıfır olmayan bir delete_length belirtin. Yeni veri ekleneceğini belirtmeyin.
Yeni veri eklemek için insert_offset değerini, 0'ın delete_length'ini ve eklenecek yeni veriyi belirtin.

En iyi performans için metin, ntext ve resim verilerinin 8.040 baytın katı olan parça boyutlarında eklenmesini veya güncellenmesini öneriyoruz.

SQL Server'da, metin, ntext veya görüntü verilerine sıralı metin göstergeleri 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.

Metin sütunlarını NULL olarak başlatmak için WRITETEXT kullanın; UPDATETEXT, metin sütunlarını boş bir dizeye başlatır.

Permissions

Belirlenen tabloda izin gereklidir UPDATE .

Examples

Aşağıdaki örnek, metin işaretçisini yerel değişkene @ptrvalyerleştirir ve ardından yazım hatasını güncellemek için kullanılır UPDATETEXT .

Uyarı

Bu örneği çalıştırmak için pubs veritabanını yüklemeniz 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'  
UPDATETEXT pub_info.pr_info @ptrval 88 1 'b';  
GO  
ALTER DATABASE pubs SET RECOVERY FULL;  
GO

Ayrıca Bkz.

METIN OKUYOR (Transact-SQL)
TEXTPTR (Transact-SQL)
METIN YAZ (Transact-SQL)

  • Last updated on