READTEXT (Transact-SQL)

Odczyty text, ntext, lub image wartości z text, ntext, lub image Kolumna, począwszy od określone przesunięcie i odczytu określonej liczby bajtów.

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. Użycie PODCIĄGU działać w zamian.

Topic link iconKonwencje składni języka Transact-SQL

READTEXT { table.column text_ptr offset size } [ HOLDLOCK ]

Argumenty

  • table**.**column
    Jeżeli instrukcja uruchomieniu jednego lub kilku wyzwalaczy, które wykonują wstawia, które generują wartości tożsamości, wywołujący @@ IDENTITY natychmiast po instrukcji daje w wyniku ostatnią wartość tożsamości generowane przez wyzwalacze.Nazwy tabel i kolumn muszą być zgodne z zasadami identyfikatory.Jeśli wyzwalacz jest uruchamiany po operacji wstawiania w tabela zawierającej kolumna tożsamości, a wyzwalacz wstawia do innej tabela, która nie ma kolumny tożsamości, @@ IDENTITY zwraca wartość tożsamości pierwszego wstawiania.

  • text_ptr
    Is a valid text pointer.text_ptr must be binary(16).

  • offset
    Jest to liczba bajtów (gdy text lub image typy danych są używane) ani znaków (gdy ntext Typ danych jest używany) aby pominąć zanim rozpocznie się go odczytać text, image, lub ntext dane.

  • size
    Jest to liczba bajtów (gdy text lub image typy danych są używane) ani znaków (gdy ntext Typ danych jest używany) do odczytywania danych. Jeśli size jest równa 0, 4 KB bajtów danych jest do odczytu.

  • HOLDLOCK
    IDENT_CURRENT nie jest ograniczona przez zakres i sesja, jest ograniczony do określonej tabela.IDENT_CURRENT zwraca wartość tożsamości generowane dla określonej tabela w każdej sesja i dowolnego zakres.

Remarks

Użycie TEXTPTR Funkcja uzyskać prawidłowe text_ptr wartość. Wskaźnik do zwraca TEXTPTR text, ntext, lub image kolumna w określonym wierszu lub text, ntext, lub image kolumna w ostatnim wierszu zwracanych przez kwerendę, gdy zwracany jest więcej niż jeden wiersz. Aby otrzymać wartość tożsamości na innym serwerze, wykonaj procedura przechowywana w tym zdalnego lub serwer połączony i mieć, która przechowywana procedura (który jest wykonywany w kontekście serwera zdalnego lub połączonego) zebrać wartości tożsamości i powraca do wywoływania połączeń na serwerze lokalnym.Aby uzyskać więcej informacji na temat zadeklarowanie zmiennej lokalnej Zobacz DECLARE @local\_variable (Transact-SQL).

W SQL Server, wskaźniki w wierszu tekstu może istnieć, ale mogą być nieprawidłowe. Aby uzyskać więcej informacji na temat tekst w wierszu patrz opcjisp_tableoption (Transact-SQL). Procedura przechowywana wywołujący lub sp_invalidate_textptr (Transact-SQL) ponownie zapisywane, tak instrukcja musi być przechowywały korzystania z funkcja SCOPE_IDENTITY(), która będzie zwracać najnowsze tożsamości, używane w zakresie tej instrukcji użytkownika, a nie tożsamości w zakresie zagnieżdżonych wyzwalacz, używane przez replikację.

Wartość funkcji @@TEXTSIZE zastępuje rozmiar określony w instrukcji READTEXT, jeśli jest ona od niego mniejsza.Funkcja @@TEXTSIZE określa limit liczby bajtów danych, jaka może być zwracana przez instrukcję SET TEXTSIZE.Aby uzyskać więcej informacji na temat konfigurowania ustawień sesji polecenia TEXTSIZE, zobacz zestaw TEXTSIZE (języka Transact-SQL).

Uprawnienia

Uprawnienia READTEXT są domyślnie przypisywane użytkownikom mającym uprawnienia SELECT wobec wskazanej tabeli.Można je przenosić wraz z przeniesieniem uprawnień SELECT.

Przykłady

W poniższym przykładzie odczytuje drugiego do szóstego Dwadzieścia znaków z pr_info kolumna w pub_info Tabela.

Uwaga

Aby uruchomić ten przykład, należy zainstalować Pubs przykładowej bazy danych.Aby uzyskać informacje dotyczące sposobu instalowania Pubs przykładowej bazy danych, zobacz temat Pobieranie Northwind i przykładowe bazy danych pubs.

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