응용프로그램 개발: 콜 레벨 인터페이스(CLI)

| | |

Trusted_Connection CLI/ODBC 구성 키워드

|

|
|
키워드 설명:
|
현재 인증된 사용자와 연결될 수 있게 합니다. |
|
구문:
|
Trusted_Connection=Yes | | |
주:
|
이 키워드는 db2cli.ini 파일이 설정된 경우 |효과가 없습니다. 그 대신 SQLDriverConnect()에 대한 |연결 문자열에서 제공되어야 합니다.
|
|
디폴트 설정:
|
DB2 CLI에서는 현재 인증된 사용자가 아닌 SQLDriverConnect()에 대한 연결 문자열에서 제공된 |사용자 ID 및 암호 정보가 사용됩니다. |
|
사용법 참고:
|
|

데이터베이스에 연결된 DB2 CLI 응용프로그램은 일반적으로 |
|SQLDriverConnect() 함수를 |사용하여 연결됩니다. 이 함수의 입력 인수 중 하나는 |DriverCompletion 값이며, 이는 창이 열릴 때 |결정됩니다. 다음은 DriverCompletion 값에 대한 내용입니다. |

|

|

| |
주:
|
DriverCompletion에 관한 자세한 정보는 |SQLDriverConnect()의 문서에서 찾을 수 있습니다.
| |

일부 응용프로그램, 예를 들어 |Kerberos 환경의 응용프로그램에서는 사용자 ID 및 암호 없이 |DB2 UDB 서버에 연결할 수 있어야 합니다. |응용프로그램이 SQLDriverConnect() 호출에서 SQL_DRIVER_NO_PROMPT 옵션을 사용하는 경우 |사용자 인증이 없어도 연결이 시도됩니다. 그러면 이 키워드가 |필요하지 않습니다.

| |

써드 파티 응용프로그램이 관련되고 응용프로그램에서 사용된 프롬프트 레벨이 |SQL_DRIVER_NO_PROMPT가 아닌 기타의 경우, |DB2 CLI에서 창이 열리며 누락된 정보가 요청됩니다. |SQLDriverConnect()의 입력 연결 문자열에 Trusted_Connection을 제공하여 |Trusted_Connection을 예로 설정한 경우(『Trusted_Connection=Yes"), |DB2 CLI에서 연결 문자열의 모든 사용자 ID 및 암호 문자열(공백 문자열 포함)이 무시되고 |연결 함수의 프롬프트 레벨이 무시됩니다. DB2 CLI에서는 |현재 인증된 사용자를 통해 데이터베이스로 연결을 시도합니다. |연결에 실패하면 사용자 ID 및 암호가 |프롬프트됩니다.

| |

이 키워드는 SQLDriverConnect()의 연결 문자열에서만 사용되므로 |db2cli.ini 파일에 이 키워드를 설정해도 아무런 효과가 나타나지 않습니다.

|
|

SQLDescribeParam 함수(CLI)의 진단 테이블 갱신

SQLDescribeParam() 함수는 Prepared SQL문과 연관된 매개변수 표시문자의 설명을 리턴합니다.

진단 테이블은 SQLSTATE HYC00으로 갱신되었습니다.

진단

표 24. SQLDescribeParam SQLSTATE
SQLSTATE 설명 설명
HYC00 사용 불가능한 드라이버 스키마 함수 스토어드 프로시저는 서버에서 액세스할 수 없습니다. 서버에 스키마 함수 스토어드 프로시저를 설치한 후 액세스 가능한지 확인하십시오.

콜 레벨 인터페이스(CLI)의 비동기 실행

DB2 CLI(DB2 Call Level Interface)는 함수의 서브세트를 비동기식으로 실행할 수 있습니다. DB2 CLI 드라이버는 함수를 호출한 후 함수 실행을 완료하기 전에 응용프로그램에 제어를 리턴합니다. 함수는 호출될 때마다 실행을 완료하기 전에 SQL_STILL_EXECUTING을 리턴하고 이때마다 서로 다른 값(예: SQL_SUCCESS)을 리턴합니다.

비동기 실행은 단일 스레드 운영 체제에서만 유용합니다. 다중 스레드 운영 체제에서 실행되는 응용프로그램은 별도의 스레드에서 함수를 실행해야 합니다. 비동기 실행은 정상적으로 서버에 요청을 보낸 후 응답을 대기하는 함수에서 가능합니다. 대기하지 않고 함수를 비동기식으로 실행하면 응용프로그램에 제어를 리턴합니다. 그러면 응용프로그램은 기타 태스크를 수행하거나 운영 체제에 제어를 리턴하고 SQL_STILL_EXECUTING 이외의 다른 리턴 코드를 리턴하기 전까지 인터럽트를 사용하여 계속 폴링합니다.

CLI 비동기 실행에 대한 지원은 DB2 UDB(Universal Database)에 버전 8.2 FixPak 1(버전 8.1 FixPak 8과 동일)부터 포함되었습니다. 이 기능의 문서는 DB2 UDB 버전 7 정보 센터(http://publib.boulder.ibm.com/infocenter/db2v7luw/index.jsp)를 참조하십시오. 버전 7 문서의 모든 정보가 버전 8.2 FixPak 1(버전 8.1 FixPak 8과 동일) 이상에 적용됩니다. DB2 버전 8 정보 센터에는 이 기능에 대한 문서가 들어 있지 않습니다.

SQL_ATTR_PING_DB 연결 속성

SQL_ATTR_PING_DB(DB2 CLI v8.2)

SQL_ATTR_PING_DB는 DB2 UDB 클라이언트와 DB2 UDB 서버 간 기존 연결에서 네트워크 응답 시간을 확보할 때 SQLGetConnectAttr() 함수에서 사용하는 32비트 정수입니다. 응답 시간은 마이크로초로 보고됩니다.

미리 연결이 설정되어 데이터베이스에서 삭제된 경우 0 값이 보고됩니다. 응용프로그램에서 연결을 닫은 경우 08003의 SQLSTATE가 보고됩니다. 이 연결 속성은 SQLGetConnectAttr()에서 리턴될 수 있지만 SQLSetConnectAttr()에서 설정될 수 없습니다. 이 속성을 설정할 경우 HYCOO의 SQLSTATE(사용 불가능한 드라이버)가 발생합니다.

SQLBindParameter 함수(CLI)

SQLBindParameter 함수의 문서에서 입력 매개변수 절에 있는 설명이 올바르지 않습니다. 올바른 설명은 다음과 같습니다.

입력 매개변수
ColumnSize가 0이면 DB2 CLI가 스토어드 프로시저 매개변수 또는 컬럼의 크기로 제공되는 SQL 유형의 최대 길이를 사용함을 의미합니다. DB2 CLI는 이 크기를 사용하여 모든 필수 변환을 수행합니다.

SQLMoreResults 함수(CLI)

SQLMoreResults 함수의 문서에서 SQL_ATTR_ROW_ARRAY_SIZE문 속성이 올바르지 않게 참조되었습니다. 올바른 명령문 속성은 SQL_ATTR_PARAMSET_SIZE입니다. 사용법 절은 다음과 같아야 합니다.

이 함수를 사용하여 다음을 실행할 때 순차적인 방식으로 다중 결과 세트를 리턴합니다.

추가 환경 속성

CLI 연결 속성과 함께 다음 속성이 CLI 환경 속성으로 지원됩니다.

이들 속성에 대한 자세한 사항은 DB2 정보 센터나 CLI Guide and Reference Volume 2에 있는 CLI 연결 속성 문서를 참조하십시오.

동적 화면 이동 커서 요구사항

동적 화면 이동 커서의 결과 세트에서 행을 갱신하거나 삭제하려면 UPDATE 또는 DELETE 명령문에 기본 테이블에서 하나 이상의 고유 키를 갖고 있는 모든 열이 포함되어야 합니다. 이 키는 기본 키나 다른 고유 키일 수 있습니다.

RetCatalogAsCurrServer CLI/ODBC 구성 키워드

키워드 설명:
카탈로그 함수는 카탈로그 컬럼에서 널(NULL) 값 대신 CURRENT SERVER 값을 리턴합니다.
db2cli.ini 키워드 구문:
RetCatalogAsCurrServer= 0 | 1
디폴트 설정:
목표 DBMS가 카탈로그 컬럼에서 널(NULL)을 리턴하는 경우 CURRENT SERVER 값을 대체하지 않습니다.
사용법 참고:
목표 DBMS의 카탈로그 함수가 카탈로그 컬럼에서 널(NULL) 값을 리턴하는 경우 RetCatalogAsCurrServer를 1로 설정하면 DBMS에서 대신 CURRENT SERVER 값을 리턴합니다.

예를 들어 카탈로그 함수 SQLTables()에서 TABLE_CAT 컬럼 값이 널(NULL) 값인 결과 세트를 리턴한다고 가정하십시오. RetCatalogAsCurrServer를 1로 설정하면 DBMS가 TABLE_CAT 컬럼에서 CURRENT SERVER 값을 리턴합니다.

주:
이 키워드는 Linux, UNIX(R) 및 Windows(R)용 DB2 UDB 버전 8.2 FixPak 3(버전 8.1 FixPak 10과 동일) 이상에서 지원됩니다.

ReceiveTimeout CLI/ODBC 구성 키워드

키워드 설명:
연결 시도를 종료하고 통신 시간종료 오류를 생성하기 전에 연결된 서버로부터의 응답을 기다리는 시간(초 단위)을 지정하십시오.
db2cli.ini 키워드 구문:
ReceiveTimeout = 0 | 1 | 2 | ... | 32767
디폴트 설정:
클라이언트는 연결된 서버로부터의 응답을 무제한 기다립니다.
동등한 연결 속성:
SQL_ATTR_RECEIVE_TIMEOUT
사용법 참고:
디폴트값 0은 클라이언트가 응답을 무제한 기다리게 된다는 것을 의미합니다. 수신 시간종료는 연결을 수립하는 동안에는 영향을 주지 않으며, TCP/IP 연결에만 지원되고 다른 프로토콜에서는 무시됩니다.

SQL_ATTR_RECEIVE_TIMEOUT 연결 속성

SQL_ATTR_RECEIVE_TIMEOUT(DB2 CLI v8)
연결 시도를 종료하고 통신 시간종료 오류를 생성하기 전에 연결된 서버로부터의 응답을 기다리는 시간(초 단위)을 나타내는 32비트 정수 값입니다. 디폴트값 0은 클라이언트가 응답을 무제한 기다리게 된다는 것을 의미합니다. 수신 시간종료는 연결을 수립하는 동안에는 영향을 주지 않으며, TCP/IP 연결에만 지원되고 다른 프로토콜에서는 무시됩니다. 0 - 32767의 정수 값이 지원됩니다.

Reopt CLI/ODBC 구성 키워드

키워드 설명:
특수 레지스터나 매개변수 표시문자가 들어 있는 SQL문의 쿼리 최적화 또는 재최적화를 사용하십시오.
db2cli.ini 키워드 구문:
Reopt = 2 | 3 | 4
디폴트 설정:
쿼리 실행 시간에 쿼리 최적화가 발생하지 않습니다. 컴파일러에 의해 선택된 디폴트 추정값은 특수 레지스터나 매개변수 표시문자에 대해 사용됩니다.
동등한 명령문 및 연결 속성:
SQL_ATTR_REOPT
사용법 참고:
최적화는 컴파일러에 의해 선택된 디폴트 추정값 대신에 쿼리 실행 시간에 특수 레지스터나 매개변수 표시문자에 대해 사용할 수 있는 값을 사용하여 실행됩니다. 유효한 키워드 값은 다음과 같습니다. "NULLIDR1" 및 "NULLIDRA"는 예약된 패키지 세트 이름이며, 이 패키지 세트들을 사용하는 경우 REOPT ONCE 및 REOPT ALWAYS가 각각 내포됩니다. 이 패키지 세트는 다음과 같은 명령을 사용하여 명시적으로 작성되어야 합니다. 
db2 bind db2clipk.bnd collection NULLIDR1
db2 bind db2clipk.bnd collection NULLIDRA
Reopt 및 CurrentPackageSet 키워드가 모두 지정된 경우 CurrentPackageSet가 우선순위를 갖습니다.

SQL_ATTR_REOPT 명령문 및 연결 속성

SQL_ATTR_REOPT(DB2 CLI v8)
특수 레지스터나 매개변수 표시문자가 포함된 SQL문의 쿼리 최적화를 활성화하는 32비트 정수 값입니다. 최적화는 컴파일러에 의해 선택된 디폴트 추정값 대신에 쿼리 실행 시간에 특수 레지스터나 매개변수 표시문자에 대해 사용할 수 있는 값을 사용하여 실행됩니다. 유효한 속성 값은 다음과 같습니다. "NULLIDR1" 및 "NULLIDRA"는 예약된 패키지 세트 이름이며, 이 패키지 세트들을 사용하는 경우 REOPT ONCE 및 REOPT ALWAYS가 각각 내포됩니다. 이 패키지 세트는 다음과 같은 명령을 사용하여 명시적으로 작성되어야 합니다. 
db2 bind db2clipk.bnd collection NULLIDR1
db2 bind db2clipk.bnd collection NULLIDRA
SQL_ATTR_REOPT와 SQL_ATTR_CURRENT_PACKAGE_SET은 상호 배타적이기 때문에 하나를 설정하면 다른 하나는 설정할 수 없습니다.

CurrentPackageSet CLI/ODBC 구성 키워드

키워드 설명:
모든 연결 후에 SET CURRENT PACKAGESET 명령문을 발행하십시오.
db2cli.ini 키워드 구문:
CurrentPackageSet = 스키마 이름
디폴트 설정:
절이 추가되지 않습니다.
동등한 연결 속성:
SQL_ATTR_CURRENT_PACKAGE_SET
사용법 참고:

이 옵션은 데이터베이스에 대해 모두 연결한 후에 CurrentPackageSet 값을 가진 SET CURRENT PACKAGESET SQL문을 발행합니다. 기본적으로 이 절은 추가되지 않습니다.

SET CURRENT PACKAGESET SQL문은 이후 SQL문에 사용할 패키지를 선택하는 데 사용되는 스키마 이름(콜렉션 ID)을 설정합니다.

CLI/ODBC 응용프로그램은 동적 SQL문을 발행합니다. 이 옵션을 사용하면 다음과 같은 명령문의 실행 특권을 제어할 수 있습니다.

이제 CLI/ODBC 응용프로그램의 SQL문이 지정된 스키마에서 실행되고, 해당 스키마에 정의된 특권을 사용합니다.

"NULLID ", "NULLIDR1" 및 "NULLIDRA"는 예약된 패키지 세트 이름입니다.

Reopt 및 CurrentPackageSet 키워드가 모두 지정된 경우 CurrentPackageSet가 우선순위를 갖습니다.

SQL_ATTR_CURRENT_PACKAGE_SET 연결 속성

SQL_ATTR_CURRENT_PACKAGE_SET(DB2 CLI v5)
차후 SQL문에 사용할 패키지를 선택하는 데 사용되는 스키마 이름(콜렉션 ID)을 나타내는 널(null) 종료 문자열입니다. 이 속성을 설정하면 SET CURRENT PACKAGESET SQL문이 발행됩니다. 연결 전에 이 속성을 설정하면 SET CURRENT PACKAGESET SQL문이 연결 시간에 발행됩니다.

CLI/ODBC 응용프로그램은 동적 SQL문을 발행합니다. 이 옵션을 사용하면 다음과 같은 명령문의 실행 특권을 제어할 수 있습니다.

이제 CLI/ODBC 응용프로그램의 SQL문이 지정된 스키마에서 실행되고, 해당 스키마에 정의된 특권을 사용합니다.

또는 CLI/ODBC 구성 키워드 CURRENTPACKAGESET를 설정하여 스키마 이름을 지정할 수 있습니다.

"NULLID ", "NULLIDR1" 및 "NULLIDRA"는 예약된 패키지 세트 이름입니다.

SQL_ATTR_REOPT와 SQL_ATTR_CURRENT_PACKAGE_SET은 상호 배타적이기 때문에 하나를 설정하면 다른 하나는 설정할 수 없습니다.

MapBigintCDefault CLI/ODBC 구성 키워드

키워드 설명:
디폴트 C 유형의 BIGINT 컬럼과 매개변수 표시문자를 지정하십시오.
db2cli.ini 키워드 구문:
MapBigintCDefault = 0 | 1 | 2
디폴트 설정:
BIGINT 데이터에 대한 디폴트 C 유형 표시는 SQL_C_BIGINT입니다.
사용법 참고:
 

MapBigintCDefault는 SQL_C_DEFAULT가 BIGINT 컬럼 및 매개변수 표시문자에 대해 지정된 경우에 사용되는 C 유형을 제어합니다. 이 키워드는 8바이트 정수를 처리할 수 없는 Microsoft(R) Access와 같은 Microsoft 응용프로그램에서 기본적으로 사용해야 합니다. 다음과 같이 MapBigintCDefault를 설정하십시오.

이 키워드는 SQL_C_DEFAULT가 C 유형으로 지정할 수 있는 CLI 함수 2005-11-04 (예: SQLBindParameter(), SQLBindCol() 및 SQLGetData()) 작동에 영향을 줍니다.

DescribeOutputLevel CLI/ODBC 구성 키워드

키워드 설명:
준비 또는 설명 요청 중 CLI 드라이버가 요청하는 출력 컬럼 설명 정보의 레벨을 설정하십시오.
db2cli.ini 키워드 구문:
DescribeOutputLevel = 0 | 1 | 2 | 3
디폴트 설정:
표 25의 레벨 2에 나열되는 설명 정보를 요청하십시오.
사용법 참고:
 

이 키워드는 준비 또는 설명 요청에서 CLI 드라이버가 요청하는 정보의 양을 제어합니다. 디폴트로, 서버가 설명 요청을 수신할 때 서버는 결과 세트 컬럼에 대해 표 25의 레벨 2에 포함된 정보를 리턴합니다. 그러나 응용프로그램은 이 모든 정보를 필요로 하지 않고 추가 정보만 필요로 할 수 있습니다.

DescribeOutputLevel 키워드를 클라이언트 응용프로그램의 필요성에 맞는 레벨로 설정하면 성능이 개선될 수 있습니다. 이는 클라이언트와 서버 사이에 전송되는 설명 데이터가 응용프로그램이 요구하는 최소 양으로 제한되기 때문입니다. DescribeOutputLevel 설정이 너무 낮으면 응용프로그램의 기능에 영향을 줄 수 있습니다(응용프로그램의 요구사항에 따라). 설명 정보를 검색하기 위한 CLI 함수는 이 경우 실패하지 않을 수 있지만 리턴되는 정보는 완전하지 않을 수 있습니다.

DescribeOutputLevel에 대해 지원되는 설정은 다음과 같습니다.

다음 표는 서버가 준비 또는 설명 요청을 수신할 때 리턴하는 설명 정보를 형성하는 필드를 나열한 것입니다. 이 필드는 레벨로 그룹화되고 DescribeOutputLevel CLI/ODBC 구성 키워드는 CLI 드라이버가 요청하는 설명 정보의 레벨을 제어합니다.

주:
모든 DB2(R) 서버에서 모든 레벨의 설명 정보가 지원되는 것은 아닙니다. Linux(TM), UNIX(R) 및 Windows(R)용 DB2 Universal Database(TM)(UDB) 버전 8 이상, z/OS(R)용 DB2 UDB 버전 8 이상 및 iSeries(TM)용 DB2 UDB 버전 5 릴리스 3 이상과 같은 DB2 서버에서는 모든 레벨의 설명 정보가 지원됩니다. 다른 모든 DB2 서버에서는 DescribeOutputLevel에 대해 2 또는 0만 설정할 수 있습니다.
표 25. 설명 정보 레벨
레벨 1 레벨 2 레벨 3 
SQL_DESC_COUNT
SQL_COLUMN_COUNT
SQL_DESC_TYPE
SQL_DESC_CONCISE_TYPE
SQL_COLUMN_LENGTH
SQL_DESC_OCTET_LENGTH
SQL_DESC_LENGTH
SQL_DESC_PRECISION
SQL_COLUMN_PRECISION
SQL_DESC_SCALE
SQL_COLUMN_SCALE
SQL_DESC_DISPLAY_SIZE
SQL_DESC_NULLABLE
SQL_COLUMN_NULLABLE
SQL_DESC_UNSIGNED
SQL_DESC_SEARCHABLE
SQL_DESC_LITERAL_SUFFIX
SQL_DESC_LITERAL_PREFIX
SQL_DESC_CASE_SENSITIVE
SQL_DESC_FIXED_PREC_SCALE
 
레벨 1의 모든 필드와 다음:
SQL_DESC_NAME
SQL_DESC_LABEL
SQL_COLUMN_NAME
SQL_DESC_UNNAMED
SQL_DESC_TYPE_NAME
SQL_DESC_DISTINCT_TYPE
SQL_DESC_REFERENCE_TYPE
SQL_DESC_STRUCTURED_TYPE
SQL_DESC_USER_TYPE
SQL_DESC_LOCAL_TYPE_NAME
SQL_DESC_USER_DEFINED_
         TYPE_CODE
 
레벨 1 및 2의 모든 필드와
다음:
SQL_DESC_BASE_COLUMN_NAME
SQL_DESC_UPDATABLE
SQL_DESC_AUTO_UNIQUE_VALUE
SQL_DESC_SCHEMA_NAME
SQL_DESC_CATALOG_NAME
SQL_DESC_TABLE_NAME
SQL_DESC_BASE_TABLE_NAME
[ 페이지의 맨 위 |이전 페이지 | 다음 페이지 | 목차 ]