READTEXT(Transact-SQL)

text, ntext 또는 image 열에서 text, ntext 또는 image 값을 지정한 오프셋에서 시작하여 지정한 바이트 수만큼 읽습니다.

중요 정보중요

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오. 대신 SUBSTRING 함수를 사용하십시오.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

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

인수

  • table**.**column
    읽을 테이블과 열의 이름입니다. 테이블 이름 및 열 이름은 식별자에 대한 규칙을 따라야 합니다. 테이블 및 열 이름은 반드시 지정해야 하지만 데이터베이스 이름과 소유자 이름을 지정하는 것은 선택적입니다.

  • text_ptr
    유효한 텍스트 포인터입니다. text_ptr은 binary(16)여야 합니다.

  • offset
    text, image 또는 ntext 데이터를 읽기 전에 건너뛸 바이트 수(text 또는 image 데이터 형식을 사용하는 경우) 또는 문자 수(ntext 데이터 형식을 사용하는 경우)입니다.

  • size
    읽을 데이터의 바이트 수(text 또는 image 데이터 형식을 사용하는 경우) 또는 문자 수(ntext 데이터 형식을 사용하는 경우)입니다. size가 0이면 4KB의 데이터가 읽혀집니다.

  • HOLDLOCK
    트랜잭션이 끝날 때까지 텍스트 값을 읽을 수 없게 잠급니다. 다른 사용자는 값을 읽을 수 있지만 수정할 수는 없습니다.

주의

유효한 text_ptr 값을 얻으려면 TEXTPTR 함수를 사용하십시오. TEXTPTR은 지정한 행 내의 text, ntext 또는 image 열을 가리키는 포인터를 반환하거나 또는 둘 이상의 행이 반환되는 경우 쿼리가 반환한 마지막 행의 text, ntext 또는 image 열을 가리키는 포인터를 반환합니다. TEXTPTR은 16바이트 이진 문자열을 반환하므로 지역 변수를 선언하여 텍스트 포인터를 보유한 다음 READTEXT로 해당 변수를 사용하는 것이 좋습니다. 지역 변수 선언 방법은 DECLARE @local\_variable(Transact-SQL)을 참조하십시오.

SQL Server에서는 행 내부 텍스트 포인터가 있을 수 있지만 유효하지 않습니다. text in row 옵션에 대한 자세한 내용은 sp_tableoption(Transact-SQL)을 참조하십시오. 텍스트 포인터를 무효화하는 방법은 sp_invalidate_textptr(Transact-SQL)를 참조하십시오.

@@TEXTSIZE 함수의 값이 READTEXT에 대해 지정한 크기보다 작을 경우 READTEXT에 대해 지정한 크기가 @@TEXTSIZE 함수의 값으로 대체됩니다. @@TEXTSIZE 함수는 SET TEXTSIZE 문에서 설정한 반환될 데이터 바이트 수를 제한합니다. TEXTSIZE의 세션 설정 방법은 SET TEXTSIZE(Transact-SQL)를 참조하십시오.

사용 권한

지정한 테이블에 대한 SELECT 권한이 있는 사용자에게 기본적으로 READTEXT 권한이 부여됩니다. SELECT 권한을 위임하는 경우에는 READTEXT 권한도 위임할 수 있습니다.

다음 예에서는 pub_info 테이블에 있는 pr_info 열의 문자를 두 번째 문자부터 26번째 문자까지 읽습니다.

[!참고]

이 예를 실행하려면 pubs 예제 데이터베이스를 설치해야 합니다. pubs 예제 데이터베이스의 설치 방법은 Northwind 및 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