다음을 통해 공유

  • 아티클

FOR 절(Transact-SQL)

FOR 절은 BROWSE 또는 XML 옵션을 지정하는 데 사용합니다. BROWSE와 XML은 서로 관련이 없는 옵션입니다.

중요 정보중요

XMLDATA 지시어에 FOR XML 옵션은 더 이상 사용되지 않습니다. RAW 및 AUTO 모드의 경우 XSD 생성을 사용하십시오. EXPLICIT 모드의 XMLDATA 지시어의 경우에는 대체할 옵션이 없습니다. Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오.

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

구문

[ FOR { BROWSE | <XML> } ]
<XML> ::=
XML 
{ 
    { RAW [ ( 'ElementName' ) ] | AUTO } 
    [ 
        <CommonDirectives> 
        [ , { XMLDATA | XMLSCHEMA [ ( 'TargetNameSpaceURI' ) ] } ] 
        [ , ELEMENTS [ XSINIL | ABSENT ] 
    ]
  | EXPLICIT 
    [ 
        <CommonDirectives> 
        [ , XMLDATA ] 
    ]
  | PATH [ ( 'ElementName' ) ] 
    [
        <CommonDirectives> 
        [ , ELEMENTS [ XSINIL | ABSENT ] ]
    ]
} 

<CommonDirectives> ::= 
[ , BINARY BASE64 ]
[ , TYPE ]
[ , ROOT [ ( 'RootName' ) ] ]

인수

  • BROWSE
    DB-Library 찾아보기 모드 커서에서 데이터를 표시하는 동안 업데이트를 허용하도록 지정합니다. 테이블에 timestamp 열이 있고 고유한 인덱스가 있으며 SQL Server 인스턴스로 전송된 SELECT 문의 끝에 FOR BROWSE 옵션이 있으면 응용 프로그램에서 테이블을 찾아볼 수 있습니다.

    [!참고]

    FOR BROWSE 옵션을 포함하는 SELECT 문에서는 <lock_hint> HOLDLOCK을 사용할 수 없습니다.

    FOR BROWSE는 UNION 연산자로 조인된 SELECT 문에는 표시되지 않습니다.

    [!참고]

    테이블의 고유 인덱스 키 열이 Null을 허용하고 테이블이 외부 조인의 내부 측면에 있으면 해당 인덱스는 찾아보기 모드에서 지원되지 않습니다.

    찾아보기 모드에서는 SQL Server 테이블의 행을 검색하고 테이블의 데이터를 한 번에 한 행씩 업데이트할 수 있습니다. 응용 프로그램에서 찾아보기 모드로 SQL Server 테이블에 액세스하려면 다음 두 가지 옵션 중 하나를 사용해야 합니다.

    • SQL Server 테이블에서 데이터에 액세스하는 데 사용하는 SELECT 문은 FOR BROWSE 키워드로 끝나야 합니다. FOR BROWSE 옵션을 설정하여 찾아보기 모드를 사용하는 경우 임시 테이블이 생성됩니다.

    • NO_BROWSETABLE 옵션을 사용하여 찾아보기 모드를 설정하려면 다음과 같은 Transact-SQL 문을 실행해야 합니다.

      SET NO_BROWSETABLE ON

      NO_BROWSETABLE 옵션을 설정할 경우 모든 SELECT 문은 FOR BROWSE 옵션이 해당 문에 추가된 것처럼 동작합니다. 하지만 NO_BROWSETABLE 옵션은 FOR BROWSE 옵션이 일반적으로 응용 프로그램에 결과를 보내기 위해 사용하는 임시 테이블을 만들지 않습니다.

    찾아보기 모드에서 외부 조인 문을 포함하는 SELECT 쿼리를 사용하여 SQL Server 테이블의 데이터에 액세스하려고 하는 경우 및 외부 조인 문의 내부에 존재하는 테이블에 고유 인덱스가 정의되어 있는 경우에는 찾아보기 모드가 고유 인덱스를 지원하지 않습니다. 찾아보기 모드에서는 모든 고유 인덱스 키 열에 Null 값을 사용할 수 있는 경우에만 고유 인덱스를 지원합니다. 찾아보기 모드에서는 다음과 같은 조건을 만족하는 경우 고유 인덱스를 지원하지 않습니다.

    • 찾아보기 모드에서 외부 조인 문을 포함하는 SELECT 쿼리를 사용하여 SQL Server 테이블의 데이터에 액세스하려고 하는 경우.

    • 외부 조인 문의 내부에 있는 테이블에 고유 인덱스가 정의되어 있는 경우.

    찾아보기 모드에서 이 동작을 재현하려면 다음 단계를 수행합니다.

    1. SQL Server Management Studio에서 SampleDB라는 이름의 데이터베이스를 만듭니다.

    2. SampleDB 데이터베이스에서 c1이라는 단일 열을 각각 포함하는 tleft 테이블과 tright 테이블을 만듭니다. tleft 테이블의 c1 열에 대한 고유 인덱스를 정의하고, Null 값을 허용하도록 해당 열을 설정합니다. 이렇게 하려면 해당하는 쿼리 창에서 다음과 같은 Transact-SQL 문을 실행합니다.

      CREATE TABLE tleft(c1 INT NULL UNIQUE) ;
GO 
CREATE TABLE tright(c1 INT NULL) ;
GO

    3. tleft 테이블과 tright 테이블에 여러 값을 삽입합니다. tleft 테이블에 Null 값을 삽입합니다. 이렇게 하려면 쿼리 창에서 다음과 같은 Transact-SQL 문을 실행합니다.

      INSERT INTO tleft VALUES(2) ;
INSERT INTO tleft VALUES(NULL) ;
INSERT INTO tright VALUES(1) ;
INSERT INTO tright VALUES(3) ;
INSERT INTO tright VALUES(NULL) ;
GO

    4. NO_BROWSETABLE 옵션을 설정합니다. 이렇게 하려면 쿼리 창에서 다음과 같은 Transact-SQL 문을 실행합니다.

      SET NO_BROWSETABLE ON ;
GO

    5. SELECT 쿼리에서 외부 조인 문을 사용하여 tleft 테이블 및 tright 테이블의 데이터에 액세스합니다. tleft 테이블이 외부 조인 문의 내부에 있는지 확인합니다. 이렇게 하려면 쿼리 창에서 다음과 같은 Transact-SQL 문을 실행합니다.

      SELECT tleft.c1 
FROM tleft 
RIGHT JOIN tright 
ON tleft.c1 = tright.c1 
WHERE tright.c1 <> 2 ;

      결과 창에서 다음과 같은 출력을 확인합니다.

      c1

      ----

      NULL

      NULL

    찾아보기 모드에서 SELECT 쿼리를 실행하여 테이블에 액세스한 후에는 오른쪽 외부 조인 문의 정의로 인해 SELECT 쿼리의 결과 집합에 tleft 테이블의 c1 열에 대한 두 Null 값이 포함됩니다. 따라서 결과 집합에서는 테이블에서 가져온 Null 값과 오른쪽 외부 조인 문으로 인해 발생한 Null 값을 구분할 수 없습니다. 결과 집합의 Null 값을 무시하면 잘못된 결과를 얻을 수 있습니다.

    [!참고]

    고유 인덱스에 포함된 열이 Null 값을 허용하지 않는 경우 결과 집합의 모든 Null 값은 오른쪽 외부 조인 문으로 인해 발생된 것입니다.

  • XML
    쿼리 결과를 XML 문서로 반환하도록 지정합니다. XML 모드는 RAW, AUTO, EXPLICIT 중 하나로 지정해야 합니다. XML 데이터 및 SQL Server에 대한 자세한 내용은 FOR XML을 사용하는 XML 생성을 참조하십시오.

  • RAW [ ('ElementName') ]
    쿼리 결과를 사용하여 결과 집합의 각 행을 요소 태그로 <row /> 일반 식별자를 갖는 XML 요소로 변환합니다. 필요에 따라 행 요소에 대한 이름을 지정할 수 있습니다. 결과 XML 출력은 각 행에 대해 행 요소가 생성될 때 지정된 ElementName을 사용합니다. 자세한 내용은 RAW 모드 사용 및 RAW 모드 사용을 참조하십시오.

  • AUTO
    단순하게 중첩된 XML 트리로 쿼리 결과를 반환합니다. 최소한 한 개의 열이 SELECT 절에 나열되는 FROM 절의 각 테이블은 XML 요소로 표시됩니다. SELECT 절에 나열되는 열은 해당 요소의 특성에 매핑됩니다. 자세한 내용은 AUTO 모드 사용을 참조하십시오.

  • EXPLICIT
    XML 결과 트리 형태가 명시적으로 정의되도록 지정합니다. 쿼리는 이 모드를 사용하여 원하는 중첩에 대한 추가 정보가 명시적으로 지정되도록 특정 방식으로 작성되어야 합니다. 자세한 내용은 EXPLICIT 모드 사용을 참조하십시오.

  • XMLDATA
    인라인 XDR 스키마를 반환하지만 결과에 루트 요소를 추가하지는 않습니다. XMLDATA를 지정하면 문서에 XDR 스키마가 첨부됩니다.

  • XMLSCHEMA [ ('TargetNameSpaceURI') ]
    인라인 XSD 스키마를 반환합니다. 이 지시어를 지정할 때 스키마에 지정된 네임스페이스를 반환하는 대상 네임스페이스 URI를 필요에 따라 지정할 수 있습니다. 자세한 내용은 인라인 XSD 스키마 생성을 참조하십시오.

  • ELEMENTS
    열을 하위 요소로 반환하도록 지정합니다. 그렇지 않은 경우에는 XML 특성에 매핑됩니다. 이 옵션은 RAW, AUTO 및 PATH 모드에서만 지원됩니다. 자세한 내용은 RAW 모드 사용을 참조하십시오.

  • XSINIL
    True로 설정된 xsi:nil 특성이 있는 요소가 NULL 열 값에 대해 생성되도록 지정합니다. 이 옵션은 ELEMENTS 지시어에만 지정할 수 있습니다. 자세한 내용은 XSINIL 매개 변수를 사용하여 NULL 값 요소 생성을 참조하십시오.

  • ABSENT
    Null 열 값에서는 해당 XML 요소가 XML 결과에 추가되지 않음을 나타냅니다. 이 옵션은 ELEMENTS에만 지정하십시오.

  • PATH [ ('ElementName') ]
    결과 집합의 각 행에 대해 <row> 요소 래퍼를 생성합니다. 필요에 따라 <row> 요소 래퍼에 대한 요소 이름을 지정할 수 있습니다. FOR XML PATH('')와 같은 빈 문자열이 지정된 경우 래퍼 요소가 생성되지 않습니다. EXPLICIT 지시어를 사용하여 작성된 쿼리 대신 PATH를 사용하는 것이 더 간단한 방법일 수 있습니다. 자세한 내용은 PATH 모드 사용을 참조하십시오.

  • BINARY BASE64
    쿼리에서 이진 데이터를 이진 base64 인코드 형식으로 반환하도록 지정합니다. RAW 및 EXPLICIT 모드를 사용하여 이진 데이터를 검색하는 경우 이 옵션을 지정해야 합니다. 이 값은 AUTO 모드에서 기본값입니다.

  • TYPE
    쿼리가 결과를 xml 형식으로 반환하도록 지정합니다. 자세한 내용은 FOR XML 쿼리의 TYPE 지시어을 참조하십시오.

  • ROOT [ ('RootName') ]
    단일 최상위 요소가 결과 XML에 추가되도록 지정합니다. 필요에 따라 생성할 루트 요소 이름을 지정할 수 있습니다. 선택 사항인 루트 이름을 지정하지 않으면 기본 <root> 요소가 추가됩니다.

예

다음 예에서는 FOR XML AUTO를 TYPE 및 XMLSCHEMA 옵션을 사용하여 지정합니다. TYPE 옵션으로 인해 결과 집합은 xml 형식으로 클라이언트에 반환됩니다. XMLSCHEMA 옵션은 반환되는 XML 데이터에 인라인 XSD 스키마가 포함되도록 지정하며 ELEMENTS 옵션은 XML 결과가 요소 중심이 되도록 지정합니다.

USE AdventureWorks;
GO
SELECT ContactID, FirstName, LastName, Phone
FROM Person.Contact
WHERE LastName LIKE 'G%'
ORDER BY LastName, FirstName 
FOR XML AUTO, TYPE, XMLSCHEMA, ELEMENTS XSINIL;