readtext (Transact-sql)
Okur text, ntext, ya imagegelen değerleri bir text, ntext, ya imagesütununda belirtilen bir ofset ve belirtilen bayt sayısını okumaya.
Önemli |
---|
Bu özellik Microsoft SQL Server'ın ilerideki bir sürümünde kaldırılacaktır. Yeni geliştirme işlerinde bu özelliği kullanmaktan kaçının ve bu özelliği kullanmakta olan uygulamalarda değişiklik yapmayı planlayın.Kullanım alt yerine çalışması. |
Transact-SQL Sözdizim Kuralları
Sözdizimi
READTEXT { table.column text_ptr offset size } [ HOLDLOCK ]
Bağımsız değişkenler
table**.**column
Bir tablo ve okumak sütun addır. Tablo ve sütun adlarını gerekir uymak için kurallar ile tanımlayıcıları. Tablo ve sütun adlarını belirtmek gereklidir; Ancak, sahibinin adı ve veritabanı adı belirtmek isteğe bağlıdır.text_ptr
Geçerli metin imleci olduğunu. text_ptrmust be binary(16).offset
Bayt sayısı (ne zaman textveya imageveri türleri kullanılır) veya karakter (zaman ntextveri türü kullanılır) okumaya başlamadan önce geçmek için text, image, veya ntextveri.size
Bayt sayısı (ne zaman textya imageveri türleri kullanılır) veya karakter (ne zaman ntextveri türü kullanılır) veri okumak için. Eğer size0, 4 kb bayt veri okumak.HOLDLOCK
Metin değeri işlemin sonuna kadar okur için kilitlenmesine neden olur. Diğer kullanıcıların değerini okuyabilir, ancak onu değiştiremez.
Açıklamalar
Kullanım textptr işlevi geçerli bir edinmek için text_ptrdeğer. textptr işlevi için bir işaretçi text, ntext, ya imagesütun belirtilen satırın veya e text, ntext, ya imagebirden fazla satır döndürülürse sorgu tarafından döndürülen son satırda sütuna. textptr 16 bayt ikili dize verdiğinden, metin imleci tutmak için yerel bir değişken bildirme tavsiye ve değişken readtext ile kullanın. Yerel bir değişken bildirme hakkında daha fazla bilgi için bkz: DECLARE @local\_variable (Transact-SQL).
De SQL Server, satır metin işaretçiler bulunabilir ancak geçerli olmayabilir. Hakkında daha fazla bilgi için satır metni seçeneği, bakın sp_tableoption (Transact-sql). Metin işaretçiler geçersiz kılmalarını hakkında daha fazla bilgi için bkz: sp_invalidate_textptr (Transact-sql).
@@ TEXTSIZE işlevi değeri o readtext için belirtilen boyuttan daha küçükse readtext için belirtilen boyutta yerini alır. @@ TEXTSIZE işlevi, veri kümesi set TEXTSIZE deyimi tarafından döndürülen bayt sayısı üst sınırını belirtir. Oturum ayarı için TEXTSIZE ayarlama hakkında daha fazla bilgi için bkz: set TEXTSIZE (Transact-sql).
İzinler
readtext belirtilen tablo üzerinde select izinlerine sahip kullanıcılar için varsayılan izinleri. select izinleri aktarıldığında izinleri devredilemez.
Örnekler
Aşağıdaki örnek üzerinden yirmi altıncı karakterden ikinci okur pr_infosütununda pub_infotablosu.
[!NOT]
Bu örneği çalıştırmak için önce yüklemeniz gerekir pub örnek veritabanı.
USE pubs;
GO
DECLARE @ptrval varbinary(16);
SELECT @ptrval = TEXTPTR(pr_info)
FROM pub_info pr INNER JOIN publishers p
ON pr.pub_id = p.pub_id
AND p.pub_name = 'New Moon Books'
READTEXT pub_info.pr_info @ptrval 1 25;
GO
USE pubs;
GO
DECLARE @ptrval varbinary(16);
SELECT @ptrval = TEXTPTR(pr_info)
FROM pub_info pr INNER JOIN publishers p
ON pr.pub_id = p.pub_id
AND p.pub_name = 'New Moon Books'
READTEXT pub_info.pr_info @ptrval 1 25;
GO