pureQuery 코드에서 정적 SQL 지원을 구성하기 위한 Default.bindProps 파일의 엔트리 구문

Default.bindProps 파일을 사용하여, SQL문이 DB2® 패키지에 바인드되는 방법을 판별하기 위한 옵션을 지정할 수 있습니다.

이 파일에서 프로젝트의 모든 인터페이스에 적용되는 옵션을 지정할 수 있습니다. 또한 개별 인터페이스에 특정한 옵션을 지정할 수도 있습니다.

이 파일에 주석을 추가할 수 있습니다. 각 주석은 # 기호로 시작하십시오.

항목을 작성하거나 편집할 때 CTRL+SPACE(또는 이 기본값을 변경한 경우 사용자 고유 키 입력)를 입력하여 지원을 사용할 수 있습니다.

구문 다이어그램을 쉽게 이해하려면 구문 다이어그램 읽는 방법을 참조하십시오.

다음 다이어그램은 이 파일에서 기본 옵션 설정에 허용되는 구문을 보여줍니다.

구문 도표 읽기시각적 구문 도표 생략
>>-defaultOptions--=--+- -bindOptions-- -"--bind-options--"-+--->
                      |                  (1)                |   
                      '-| DBRM options |--------------------'   

>--+----------------+--+--------------------------+------------->
   |            (2) |  '- -isolationLevel--+-CS-+-'   
   '-| -grant |-----'                      +-RR-+     
                                           +-RS-+     
                                           '-UR-'     

>--+-----------------------+-----------------------------------><
   |                   (3) |   
   '-| Trace options |-----'   

주:
  1. 구문의 경우 해당 옵션의 설명을 참조하십시오.
  2. 구문의 경우 해당 옵션의 설명을 참조하십시오.
  3. 구문의 경우 해당 옵션의 설명을 참조하십시오.

다음 구문 다이어그램은 파일에 나열된 개별 인터페이스에 대한 옵션 설정에 허용되는 구문을 보여줍니다.

구문 도표 읽기시각적 구문 도표 생략
>>-Java-package.interface--=------------------------------------>

>--+- -bindOptions-- -"--bind-options--"-+---------------------->
   |                  (1)                |   
   '-| DBRM options |--------------------'   

>--+----------------+--+--------------------------+------------><
   |            (2) |  '- -isolationLevel--+-CS-+-'   
   '-| -grant |-----'                      +-RR-+     
                                           +-RS-+     
                                           '-UR-'     

주:
  1. 구문의 경우 해당 옵션의 설명을 참조하십시오.
  2. 구문의 경우 해당 옵션의 설명을 참조하십시오.
defaultOptions
행의 옵션이 이 파일에 나열된 모든 인터페이스의 SQL문에 적용되도록 지정합니다. 파일의 한 행만 이 키워드로 시작할 수 있습니다.
Java-package.interface (옵션 파일의 행 시작에서)
행의 옵션이 지정된 인터페이스의 SQL문에만 적용되도록 지정합니다. 해당 옵션은 기본값으로 지정한 옵션을 겹쳐씁니다.
인터페이스가 해당되는 Java™ 패키지의 이름으로 인터페이스 이름을 지정해야 합니다.
-bindOptions "string-of-bind-options"
해당 옵션의 기능은 같은 이름으로 지정된 DB2 프리컴파일 및 바인드 옵션의 기능과 같습니다. 프로그램이 z/OS®용 DB2 시스템에서 실행되도록 준비하는 경우, z/OS용 DB2 옵션을 지정하십시오. 프로그램이 Linux®, UNIX® 및 Windows®용 DB2 시스템에서 실행되도록 준비하는 경우, Linux, UNIX 및 Windows용 DB2 옵션을 지정하십시오.

문자열 구문은 "option_1 value_1 option_2 value_2"입니다.

해당 옵션의 목록 및 설명은 BIND command를 참조하십시오.
REOPT 바인드 옵션이 pureQuery 코드에서 유용할 수 있습니다. 이 옵션과 함께 SQL문에 매개변수 표시문자를 사용할 수 있으며 DB2 액세스 경로를 계속 최적화할 수 있습니다. 지원되는 DB2 데이터베이스에서 이 옵션 사용에 대한 정보는 다음 링크를 참조하십시오.
DBRM options
패키지를 작성하지 않고 DBRM 파일을 생성하려면 이 옵션을 사용하십시오. 이 옵션은 z/OS용 DB2를 사용하는 경우에만 적용됩니다.

StaticBinder 유틸리티가 DBRM 파일을 생성한 후 해당 파일을 데이터 세트에 복사해야 합니다. 기본 DBRM 데이터 세트 이름은 prefix.DBRMLIB.DATA이며 여기서 prefix는 사용자에 대해 TSO 프로파일에 지정된 상위 레벨 규정자입니다. prefix는 일반적으로 TSO에서의 사용자 ID입니다.

DBRM 데이터 세트가 존재하지 않는 경우 이를 작성해야 합니다. DBRM 데이터 세트에는 모든 SQL문을 보관하기 위한 스페이스 및 각 호스트 변수 이름과 일부 헤더 정보를 위한 추가 스페이스가 필요합니다. 헤더 정보에는 대략 각 DBRM에 대해 두 개의 레코드, 각 SQL 레코드용으로 20바이트 및 각 호스트 변수용으로 6바이트가 필요합니다. DBRM의 정확한 형식은 prefix.SDSNMACS 라이브러리에서 DBRM 맵핑 매크로인 DSNXDBRM을 참조하십시오.

다음 구문 다이어그램은 DBRM 파일 생성 옵션을 설명합니다.

구문 도표 읽기시각적 구문 도표 생략
>>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--path-----------><
                   '-FALSE-'                           

-generateDBRM
패키지를 작성하는 대신에 DBRM 파일을 생성하는지 여부를 지정합니다. generateDBRMTRUE인 경우 기본으로 StaticBinder 유틸리티가 4개의 DBRM 파일(분리 레벨 CS, RR, RS, UR 각각에 대해 하나씩)을 생성합니다. 그러나 -isolationLevel 옵션을 지정하는 경우 하나의 DBRM 파일만 생성할 수 있습니다.

생성된 DBRM 파일의 루트 이름은 Generator 유틸리티를 실행할 때 지정한 루트 패키지 이름입니다. 이 이름이 7자를 넘지 않는다면 StaticBinder 유틸리티가 예외로 처리합니다.

-outputDBRMPath path
생성된 DBRM 파일을 저장하기 위한 디렉토리를 지정합니다. 기본값은 StaticBinder 유틸리티를 실행한 디렉토리입니다.
-grant "grantees(firstID,secondID,...)"
StaticBinder 유틸리티가 작성하는 패키지에 EXECUTE 특권을 부여할 사용자에게 쉼표로 구분되는 권한 받은 사용자 목록(괄호로 표시된)을 지정합니다. 이 옵션을 지정하지 않으면 StaticBinder 유틸리티는 이 특권을 권한 부여하지 않습니다.
구문 도표 읽기시각적 구문 도표 생략
                             .-,--------------------.          
                             V                      |          
>>- -grant-- "--grantees--(----+-authorization-ID-+-+--) - "---><
                               '-PUBLIC-----------'            

grantees
EXECUTE 특권을 권한 부여할 쉼표로 구분된 권한 부여 ID 목록입니다. 나열한 권한 부여 ID는 사용 중인 DB2 데이터베이스에 대해 유효해야 합니다.

Linux, UNIX 및 Windows용 DB2 데이터베이스: USER, GROUP 및 ROLE 키워드를 사용할 수 있습니다. 이들 키워드에 관한 정보는 GRANT(패키지 특권) 명령문을 참조하십시오.

z/OS용 DB2: ROLE 키워드를 사용할 수 있습니다. 이 키워드에 관한 정보는 GRANT(패키지 특권)를 참조하십시오.

제한사항: -generateDBRM 옵션 값이 TRUE이면 -grant 옵션을 사용할 수 없습니다.

-isolationLevel CS | RR | RS | UR
4개의 분리 레벨 각각에 대해 DB2 패키지나 DBRM 파일을 하나씩 생성하지 않고 특정 분리 레벨에 대한 단일 DB2 패키지 또는 DBRM 파일을 생성하도록 지정합니다.

분리 레벨은 패키지에 있는 모든 SQL문에 적용됩니다. 분리 레벨을 JDBC 및 SQLJ용 IBM® 데이터 서버 드라이버의 Connection.setTransactionIsolation() 메소드를 통해 설정하면, pureQuery는 정적으로 실행된 명령문의 해당 분리 레벨을 무시합니다.

UR
언커미트 읽기를 분리 레벨로 지정합니다.
Generator 유틸리티를 실행 시 -forceSingleBindIsolation 옵션을 사용하지 않았다면 StaticBinder 유틸리티가 작성된 패키지 또는 DBRM 파일의 이름에 1을 추가합니다.
Configure 유틸리티를 실행 시 -forceSingleBindIsolation 옵션을 사용하지 않았다면 StaticBinder 유틸리티가 작성된 패키지 또는 DBRM 파일의 이름에 1을 추가합니다.
CS
커서 안정성을 분리 레벨로 지정합니다.
Generator 유틸리티를 실행 시 -forceSingleBindIsolation 옵션을 사용하지 않았다면 StaticBinder 유틸리티가 작성된 패키지 또는 DBRM 파일의 이름에 2를 추가합니다.
Configure 유틸리티를 실행 시 -forceSingleBindIsolation 옵션을 사용하지 않았다면 StaticBinder 유틸리티가 작성된 패키지 또는 DBRM 파일의 이름에 2를 추가합니다.
RS
읽기 안정성을 분리 레벨로 지정합니다. 읽기 안정성 레벨에서는 애플리케이션이 읽고 변경하는 행에 대한 다른 애플리케이션 프로세스와 별도로 패키지의 SQL문이 실행됩니다.
Generator 유틸리티를 실행 시 -forceSingleBindIsolation 옵션을 사용하지 않았다면 StaticBinder 유틸리티가 작성된 패키지 또는 DBRM 파일의 이름에 3을 추가합니다.
Configure 유틸리티를 실행 시 -forceSingleBindIsolation 옵션을 사용하지 않았다면 StaticBinder 유틸리티가 작성된 패키지 또는 DBRM 파일의 이름에 3을 추가합니다.
RR
반복 읽기를 분리 레벨로 지정합니다.
Generator 유틸리티를 실행 시 -forceSingleBindIsolation 옵션을 사용하지 않았다면 StaticBinder 유틸리티가 작성된 패키지 또는 DBRM 파일의 이름에 4를 추가합니다.
Configure 유틸리티를 실행 시 -forceSingleBindIsolation 옵션을 사용하지 않았다면 StaticBinder 유틸리티가 작성된 패키지 또는 DBRM 파일의 이름에 4를 추가합니다.

피드백