Udostępnij za pośrednictwem

  • Artykuł

UPDATETEXT (Transact-SQL)

Aktualizuje istniejące text, ntext, lub image pole. Umożliwia zmianę tylko część UPDATETEXT text, ntext, lub image Kolumna w miejscu. Użyj WRITETEXT aktualizacji i zastąpić całości text, ntext, lub image pole.

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żywane typy danych dużą wartość a . Klauzula zapisuAKTUALIZACJA instrukcja w zamian.

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

UPDATETEXT { 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 } ]

Argumenty

  • table_name**.**dest_column_name
    Jest to nazwa tabela i text, ntext, lub image kolumna mają być aktualizowane. Tabela nazw i kolumna nazwy muszą być zgodne z zasadami identyfikatory.Określanie nazwy bazy danych i nazwy właściciela jest opcjonalne.

  • dest_text_ptr
    Is a text pointer value (returned by the TEXTPTR function) that points to the text, ntext, or image data to be updated.dest_text_ptr must be binary(16).

  • insert_offset
    Jest pozycją początkową od zera dla aktualizacji.Dla text lub image kolumna, insert_offset jest to liczba bajtów, aby pominąć od początku istniejącej kolumna przed wstawieniem nowych danych. For ntext columns, insert_offsetis the number of characters (each ntext character uses 2 bytes).Istniejące text, ntext, lub image dane, począwszy od tej pozycji początkowej od zera jest przesunięte w prawo, aby zwolnić miejsce dla nowych danych. Wartość 0, wstawia nowe dane na początku istniejących danych.Wartość NULL dołącza nowe dane do istniejącej wartości danych.

  • delete_length
    Jest to długość danych do usunięcia z istniejącego pliku text, ntext, lub image kolumna, począwszy od insert_offset pozycja. The delete_lengthvalue is specified in bytes for text and image columns and in characters for ntext columns.Każdy ntext znak wykorzystuje 2 bajty. Wartość 0 usunie żadnych danych.Wartość NULL powoduje usunięcie wszystkich danych z insert_offset Umieść na końcu istniejącego pliku text lub image Kolumna.

  • Z DZIENNIKIEM
    Rejestrowanie jest określana przez model odzyskiwanie dotyczące bazy danych.

  • inserted_data
    Dane, to ma zostać wstawiony do istniejącego pliku text, ntext, lub image kolumna w insert_offset Lokalizacja. This is a single char, nchar, varchar, nvarchar, binary, varbinary, text, ntext, or image value.inserted_data can be a literal or a variable.

  • table_name.src_column_name
    Jest to nazwa tabela i text, ntext, lub image kolumna służył jako urządzenie źródłowe danych wstawianych. Nazwy tabel i nazwy kolumn muszą być zgodne z regułami identyfikatorów.

  • src_text_ptr
    Jest wskaźnikiem tekstu wartość (zwracana przez funkcja TEXTPTR), który wskazuje text, ntext, lub image używany jako urządzenie źródłowe danych wstawianych kolumn.

    Uwaga

    scr_text_ptrvalue must not be the same as dest_text_ptrvalue.

Remarks

Nowo wstawionych danych może być jednym inserted_data stała, nazwę tabela, nazwę kolumna lub wskaźnik tekstu.

Zaktualizować akcja

Parametry UPDATETEXT

Aby zamienić istniejące dane

Określ nonnull insert_offset wartość różną od zera, delete_length wartość, a nowe dane do wstawienia.

Aby usunąć istniejące dane

Określ nonnull insert_offset wartość i różna od zera, delete_length. Nie określono nowych danych do wstawienia.

Aby wstawić nowe dane

Określ insert_offset wartość, delete_length 0, i nowych danych do wstawienia.

Aby uzyskać najlepszą wydajność zaleca się, że text, ntext i image dane można wstawione lub zaktualizowane w rozmiary fragmentów, które są wielokrotności 8,040 bajtów.

W SQL Server, w wierszu tekstu łącza do text, ntext, lub image dane mogą istnieć, ale mogą być nieprawidłowe. Aby uzyskać informacje dotyczące tekst w wierszu patrz opcjisp_tableoption (Transact-SQL). Aby uzyskać informacje na temat unieważnienia tekst łącza Zobacz sp_invalidate_textptr (Transact-SQL).

Aby zainicjować text kolumny mają wartość NULL, używać UPDATETEXT poziom zgodności jest równa 65. Jeśli poziom zgodności jest równy 70, użyj WRITETEXT zainicjować kolumn tekstowych na wartość NULL; w przeciwnym razie inicjuje UPDATETEXT text kolumny na pusty ciąg. Aby uzyskać informacje na temat ustawiania poziom zgodności zobacz sp_dbcmptlevel (języka Transact-SQL).

Uprawnienia

Wymaga uprawnienia UPDATE dla określonej tabela.

Przykłady

W następującym przykładzie powoduje umieszczenie tekstu wskaźnik myszy w zmiennej lokalnej @ptrval, a następnie używa UPDATETEXT Aby zaktualizować błąd pisowni.

Uwaga

Do uruchomienia tego przykładu jest wymagane zainstalowanie bazy danych pubs.Aby uzyskać informacje dotyczące sposobu instalowania bazy danych pubs, zobacz Pobieranie Northwind i przykładowe bazy danych pubs.

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