READTEXT(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

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

Important

이 기능은 이후 버전의 SQL Server에서 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 SUBSTRING 함수를 사용합니다.

Transact-SQL 구문 표기 규칙

Syntax

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

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

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

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

offset
text 또는 image 데이터 형식을 사용하는 경우 바이트 수입니다. text, image 또는 ntext 데이터를 읽기 전에 건너뛰기 위해 ntext 데이터 형식을 사용하는 경우 문자의 바이트 수일 수도 있습니다.

sizetext 또는 image 데이터 형식을 사용하는 경우 바이트 수입니다. 데이터를 읽기 위해 ntext 데이터 형식을 사용하는 경우 문자의 바이트 수일 수도 있습니다. size가 0이면 4KB의 데이터를 읽습니다.

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

설명

유효한 text_ptr 값을 얻으려면 TEXTPTR 함수를 사용하십시오. TEXTPTR은 지정된 행에 text, ntext 또는 image 열에 대한 포인터를 반환합니다. TEXTPTR은 쿼리에서 둘 이상의 행을 반환하는 경우 반환되는 마지막 행에 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 권한도 위임할 수 있습니다.

예

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

참고

이 예를 실행하려면 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

참고 항목

@@TEXTSIZE(Transact-SQL)
UPDATETEXT(Transact-SQL)
WRITETEXT(Transact-SQL)