|"다중 스레드 혼합 응용프로그램" 섹션에 다음의 내용을 추가해야 합니다.
다음은 이 장의 새로운 섹션입니다.
DB2 CLI 유니코드 응용프로그램 지원의 두 주요 영역이 있습니다.
다음은 유니코드(W) 및 ANSI(A) 버전을 모두 지원하는 ODBC API 함수의 목록입니다. (유니코드의 경우 함수 이름에 W가 있습니다.)
SQLBrowseConnect SQLForeignKeys SQLPrimaryKeys SQLColAttribute SQLGetConnectAttr SQLProcedureColumns SQLColAttributes SQLGetConnectOption SQLProcedures SQLColumnPrivileges SQLGetCursorName SQLSetConnectAttr SQLColumns SQLGetDescField SQLSetConnectOption SQLConnect SQLGetDescRec SQLSetCursorName SQLDataSources SQLGetDiagField SQLSetDescField SQLDescribeCol SQLGetDiagRec SQLSetStmtAttr SQLDriverConnect SQLGetInfo SQLSpecialColumns SQLDrivers SQLGetStmtAttr SQLStatistics SQLError SQLNativeSQL SQLTablePrivileges SQLExecDirect SQLPrepare SQLTables
문자열 길이인수를 리턴 또는 취하는 유니코드 함수는 문자수로서 전달됩니다. 서버 데이터에 대한 길이 정보를 리턴하는 함수의 경우, 표시 크기와 정밀도는 문자 수로 설명합니다. 길이(데이터의 전송 크기)가 문자열 또는 비문자열 데이터를 참조할 수 있는 경우, 길이는 8진수로 설명됩니다. 예를 들어, SQLGetInfoW는 길이를 바이트수로 취하지만, SQLExecDirectW는 문자수를 사용합니다. CLI는 응용프로그램의 바인딩에 따라 결과 세트를 유니코드 또는 ANSI로 리턴합니다. 응용프로그램이 SQL_C_CHAR에 바인드할 경우, 드라이버는 SQL_WCHAR 데이터를 SQL_CHAR로 변환합니다. 드라이버 관리 프로그램은 ANSI 드라이버를 위해 SQL_C_WCHAR을 SQL_C_CHAR에 맵핑하지만 유니코드 드라이버를 위해서는 맵핑하지 않습니다.
두 새로운 CLI 또는 ODBC 정의 데이터 유형, SQL_C_WCHAR과 SQL_WCHAR이 있습니다. SQL_C_WCHAR은 C 버퍼에 UCS-2 데이터가 있음을 의미합니다. SQL_WCHAR은 특정 컬럼 또는 매개변수 표시문자에 유니코드 데이터가 들어 있음을 의미합니다. DB2 유니코드 서버의 경우, 그래픽 컬럼은 SQL_WCHAR로 설명됩니다. 변환은 그래픽 데이터 유형 사이에서 뿐만 아니라 SQL_C_WCHAR과 SQL_CHAR, SQL_VARCHAR,SQL_LONGVARCHAR 및 SQL_CLOB 사이에서 허용됩니다.
|
SQL 데이터 유형 |
S Q L _ C _ C H A R |
S Q L _ C _ W C H A R |
S Q L _ C _ L O N G |
S Q L _ C _ S H O R T |
S Q L _ C _ T I N Y I N T |
S Q L _ C _ F L O A T |
S Q L _ C _ D O U B L E |
S Q L _ C _ T Y P E _ D A T E |
S Q L _ C _ T Y P E _ T I M E |
S Q L _ C _ T Y P E _ T I M E S T A M P |
S Q L _ C _ B I N A R Y |
S Q L _ C _ B I T |
S Q L _ C _ D B C H A R |
S Q L _ C _ C L O B _ L O C A T O R |
S Q L _ C _ B L O B _ L O C A T O R |
S Q L _ C _ D B C L O B _ L O C A T O R |
S Q L _ C _ B I G I N T |
S Q L _ C _ N U M E R I C |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BLOB |
X |
X |
|
|
|
|
|
|
|
|
D |
|
|
|
X | |||
|
CHAR |
D |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
|
|
|
X |
X | |
|
CLOB |
D |
X |
|
|
|
|
|
|
|
|
X |
|
|
X |
| |||
|
DATE |
X |
X |
|
|
|
|
|
D |
|
X |
|
|
|
|
| |||
|
DBCLOB |
|
X |
|
|
|
|
|
|
|
|
X |
|
D |
|
|
X | ||
|
DECIMAL |
D |
X |
X |
X |
X |
X |
X |
|
|
|
X |
X |
|
|
|
X |
X | |
|
DOUBLE |
X |
X |
X |
X |
X |
X |
D |
|
|
|
|
X |
|
|
|
X |
X | |
|
FLOAT |
X |
X |
X |
X |
X |
X |
D |
|
|
|
|
X |
|
|
|
X |
X | |
|
GRAPHIC (비 유니코드) |
X |
X |
|
|
|
|
|
|
|
|
|
|
D |
|
| |||
|
GRAPHIC(유니코드) |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
D |
|
|
|
X |
|
|
INTEGER |
X |
X |
D |
X |
X |
X |
X |
|
|
|
|
X |
|
|
|
X |
X | |
|
LONG VARCHAR |
D |
X |
|
|
|
|
|
|
|
|
X |
|
|
|
| |||
|
LONG VARGRAPHIC (비 유니코드) |
X |
X |
|
|
|
|
|
|
|
|
X |
|
D |
|
| |||
|
LONG VARGRAPHIC (유니코드) |
X |
X |
|
|
|
|
|
|
|
|
X |
|
D |
|
|
|
|
|
|
NUMERIC |
D |
X |
X |
X |
X |
X |
X |
|
|
|
|
X |
|
|
|
X | ||
|
REAL |
X |
X |
X |
X |
X |
D |
X |
|
|
|
|
X |
|
|
|
X | ||
|
SMALLINT |
X |
X |
X |
D |
X |
X |
X |
|
|
|
|
X |
|
|
|
X |
X | |
|
BIGINT |
X |
X |
X |
X |
X |
X |
X |
|
|
|
X |
X |
|
|
|
D |
X | |
|
TIME |
X |
X |
|
|
|
|
|
|
D |
X |
|
|
|
|
| |||
|
TIMESTAMP |
X |
X |
|
|
|
|
|
X |
X |
D |
|
|
|
|
| |||
|
VARCHAR |
D |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
|
|
|
X |
X | |
|
VARGRAPHIC (비 유니코드) |
X |
X |
|
|
|
|
|
|
|
|
|
|
D |
|
| |||
|
VARGRAPHIC (유니코드) |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
X |
D |
|
|
|
X |
|
유니코드 응용프로그램이 지원되기 전에 1바이트 문자 데이터로 작업하도록 작성된 응용프로그램은 GRAPHIC=1,2 또는 3, Patch2=7 등과 같이 일련의 cli ini 파일 키워드 시리즈에 의해 2바이트 그래픽 데이터로 작업하도록 만들 수 있습니다. 이와 같은 임시 조치에 따라 그래픽 데이터가 문자 데이터로 표시되며 또한 보고되는 데이터의 길이가 달라집니다.
|이들 키워드는 유니코드 응용프로그램에 더 이상 필요하지 않으며, |실제로 심각한 부작용이 있으므로 사용해서는 안됩니다. 이를 알고 있지 않으면, 특정 |응용프로그램이 유니코드 응용프로그램일 경우, 그래픽 데이터 처리에 영향을 |주는 키워드 없이 시도하도록 권장합니다.
비 유니코드 데이터베이스에서 LONG VARGRAPHIC 및 LONG VARCHAR 컬럼의 데이터는 비교될 수 없습니다. 내재된 코드 페이지 변환이 지원되지 않으므로 GRAPHIC/VARGRAPHIC 및 CHAR/VARCHAR 컬럼의 데이터는 명시적 유형변환(cast) 함수를 사용하여 서로 비교하거나 할당될 수만 있었습니다. 여기에는 GRAPHIC/VARGRAPHIC 리터럴이 CHAR/VARCHAR 리터럴과 G 접두부에 의해 차별화되는 GRAPHIC/VARGRAPHIC 및 CHAR/VARCHAR 리터럴이 포함됩니다.
유니코드 데이터베이스의 경우, GRAPHIC/VARGRAPHIC과 CHAR/VARCHAR 리터럴 사이의 유형변환(CAST)은 필요하지 않습니다. 또한, G 접두부가 GRAPHIC/VARGRAPHIC 리터럴 앞에 필요하지 않습니다. 최소한 한 인수가 리터럴이면, 내재된 변환이 발생합니다. 이는 G 접두부가 있거나 없는 리터럴을 SQLPrepareW() 또는 SQLExecDirect()를 사용하는 명령문 내에서 사용할 수 있도록 해줍니다. LONG VARGRAPHIC의 리터럴은 G 접두부를 가져야합니다.
자세한 정보는 SQL 참조서의 "제3장 언어 요소"에서 "데이터 유형간 유형변환"을 참조하십시오.
다음 세 개의 키워드를 추가하여 유니코드 응용프로그램이 데이테이스에 연결될 때 여분의 오버헤드를 피할 수 있도록 하였습니다.
유니코드 지원이 사용 가능하고, 유니코드 응용프로그램이 호출한 경우, 코드페이지 변환에 의한 불필요한 자료 손실이 없도록 보장하기 위하여 CLI는 최선의클라이언트 코드 페이지를 사용하여 데이터베이스에 연결하려고 시도합니다. 이는 코드 페이지가 교환되므로 연결 시간을 증가시키거나 또는 이러한 지원이 추가되기 이전에는 발생치 않았던 클라이언트에서의 코드 페이지 변환을 초래할 수 있습니다.
이 키워드를 True로 설정하면, 데이터가 서버에 송신되기 이전에 우선적으로 모든 유니코드 데이터가 응용프로그램의 국지 코드 페이지로 변환되도록 합니다. 이는 국지 코드 페이지에서 대표될 수 없는 데이터의 데이터 손실을 초래할 수 있습니다.
비 유니코드 응용프로그램은 언제나 응용프로그램의 지역 코드페이지 또는 DB2Codepage 환경설정을 사용하여 데이터베이스에 연결합니다. 기본값으로 CLI는 유니코드 응용프로그램이 UTF-8 및 UCS-2 코드 페이지를 사용하여 유니코드 데이터베이스에 연결되도록 보장하며, 데이터베이스의 코드 페이지를 사용하여 비 유니코드 데이터베이스에 연결됩니다. 이는 코드 페이지 변환에 따른 불필요한 데이터 손실이 생기지 않도록 보장합니다.
연결시에 여분의 오버헤드를 피하기 위하여 비 유니코드 데이터베이스에 연결하는 경우, 사용자는 이 키워드를 사용하여 데이터베이스의 코드 페이지를 지정할 수 있습니다.
값 1을 지정하여 SQLDriverConnect()가 출력 연결 문자열에서 올바른 값을 리턴하도록 하여 해당 값이 미래의 SQLDriverConnect() 호출에 사용될 수 있도록 합니다.
이 키워드는 ConnectCodepage=1208과 동일하며 편리성을 위해 추가하였습니다. OS/390 버전 7 또는 그 이상의 DB2에 연결하는 경우, 이 키워드를 사용하여 여분의 연결 오버헤드를 피할 수 있습니다. 여분의 처리가 필요하지 않으므로, 이 키워드를 Windows의 DB2, Unix의 DB2 또는 OS/2 데이터베이스의 DB2에 사용할 필요는 없습니다.
|다음은 "설치 및 구성" 서브섹션의 DISABLEMULTITHREAD 구성 키워드 기본값을 정정합니다. |
다음 정보는 "화면 이동 커서" 섹션에 추가되어야 합니다.
Unix, Windows 및 OS/2 플랫폼용 UDB 클라이언트는 OS/390 버전 7 데이터베이스에 대해 수행할 때 갱신가능한 서버측 화면 이동 커서를 지원합니다. 3층(three-tier) 환경에서 OS/390 화면 이동 커서를 액세스하려면, 클라이언트 및 게이트웨이가 DB2 UDB 버전 7.1, FixPak 3 이상을 실행 중이어야 합니다.
화면 이동 커서를 액세스할 수 있는 2개의 응용프로그램 사용 인터페이스(ODBC 및 JDBC)가 있습니다. JDBC 인터페이스는 정적 화면 이동 커서만을 액세스할 수 있지만, ODBC 인터페이스는 정적 및 keyset 위주(keyset-driven) 서버측 화면 이동 커서를 액세스할 수 있습니다.
아래 테이블은 ODBC에서 OS/390 버전 7 커서에 대한 기본 속성을 나열합니다.
표 11. ODBC에서 OS/390 커서에 대한 기본 속성
| 커서 유형 | 커서 민감성 | 커서 갱신가능 | 커서 동시성 | 커서 화면 이동 |
|---|---|---|---|---|
| 포워드 전용a | 미지정 | 갱신가능하지 않음 | 읽기 전용 동시성 | 화면 이동 가능하지 않음 |
| 정적 | 민감하지 않음 | 갱신가능하지 않음 | 읽기 전용 동시성 | 화면 이동 |
| keyset 위주 (keyset-driven) | 민감함 | 갱신가능 | 값 동시성 | 화면 이동 |
|
| ||||
모든 ODBC 페치 방향은 SQLFetchScroll 또는 SQLExtendedFetch 인터페이스를 통해 지원됩니다.
keyset 위주(keyset-driven) 커서는 갱신가능한 커서입니다. CLI 드라이버는 조회가 SELECT ... FOR READ ONLY 조회로서 발행되거나 FOR UPDATE 절이 이미 존재하는 경우를 제외하고 FOR UPDATE 절을 조회에 추가합니다. OS/390용 DB2에서 구현되는 keyset 위주(keyset-driven) 커서는 값 동시성 커서입니다. 값 동시성 커서는 최적 잠금의 결과를 가져오며, 여기서 값은 갱신이나 삭제가 시도될 때까지 보유되지 않습니다. 갱신 또는 삭제가 시도되면, 데이터베이스 서버는 응용프로그램이 검색한 이전 값과 주요 테이블의 현재 값을 비교합니다. 값이 일치하는 경우, 갱신 또는 삭제가 성공합니다. 값이 일치하지 않는 경우, 조작이 실패합니다. 실패한 경우, 응용프로그램은 다시 값을 조회하고 여전히 적용가능하다면 갱신 또는 삭제를 다시 발행해야 합니다.
응용프로그램은 두가지 방식으로 keyset 위주(keyset-driven) 커서를 갱신할 수 있습니다.
화면 이동 커서 지원은 새로운 기능이므로, OS/390용 UDB 또는 Unix, Windows 및 OS/2용 UDB는 행동 또는 성능 변경이 발생할 수 있습니다. 화면 이동 커서가 지원되기 전에는, 화면 이동 커서를 요청한 응용프로그램이 포워드 전용 커서를 받기 때문에 이런 경우가 발생합니다. 화면 이동 커서 지원하기 전의 응용프로그램의 이전 활동을 복원하려면, 다음과 같은 구성 키워드를 db2cli.ini 파일에 설정하십시오.
표 12. 화면 이동 커서가 지원하기 전에 응용프로그램 활동을 복원하는 구성 키워드 값
| 구성 키워드 설정 | 설명 |
|---|---|
| PATCH2=6 | 화면 이동 커서(keyset 위주(keyset-driven) 및 정적 모두)가 지원되지 않음을 나타내는 메시지를 리턴합니다. CLI는 자동으로 화면 이동 커서에 대한 모든 요청을 포워드 전용 커서로 낮춥니다. |
| DisableKeysetCursor=1 | 서버측 및 클라이언트측 keyset 위주(keyset-driven) 화면 이동 커서 모두를 사용하지 않습니다. 이것은 keyset 위주(keyset-driven) 커서가 요청될 때 CLI 드라이버가 응용프로그램에 정적 커서를 부여하도록 강제하는 데 사용될 수 있습니다. |
| UseServerKeysetCursor=0 | 클라이언트측 keyset 위주(keyset-driven) 커서 라이브러리를 사용 중인 응용프로그램의 서버측 keyset 위주(keyset-driven) 커서를 사용하지 않음으로써 keyset 위주(keyset-driven) 커서를 시뮬레이트합니다. 클라이언트측 커서가 많은 양의 오버헤드를 발생시키고 일반적으로 서버특 커서보다 성능이 나쁘므로 서버측 keyset 위주(keyset-driven) 커서에서 문제점이 발생할 때만 이 옵션을 사용하십시오. |
다음의 주의사항이 책에서 누락되었습니다.
Any SQL statement that can be prepared dynamically, other than a query, can be executed as a statement inside a compound statement. Note: Inside Atomic Compound SQL, savepoint, release savepoint, and rollback to savepoint SQL statements are also disallowed. Conversely, Atomic Compound SQL is disallowed in savepoint.
다음은 CLI 저장 프로시듀어에 대해 문서화되지 않은 제한사항입니다.
If you are making calls to multiple CLI stored procedures, the application must close the open cursors from one stored procedure before calling the next stored procedure. More specifically, the first set of open cursors must be closed before the next stored procedure tries to open a cursor.
다음은 이 책의 정보를 보충하는 내용입니다.
CLI/ODBC 드라이버는 사용자가 적합한 특권 또는 권한을 갖고 있는 경우, 보통 CLI/ODBC 응용프로그램이 데이터베이스에 대해 SQL을 처음 실행할 때 CLI 패키지를 자동으로 바인드합니다. CLI 패키지의 자동 바인드는 저장 프로시듀어내에서 수행될 수 없으므로, 응용프로그램이 수행하는 제일 처음 동작이 CLI 저장 프로시듀어를 호출하는 것인 경우 발생하지 않습니다. 그러므로, 새 데이터베이스에 대해 CLI 저장 프로시듀어를 호출하는 CLI 응용프로그램을 실행하기 전에, 이 명령으로 CLI 패키지를 한번 바인드해야 합니다.
db2 bind <BNDPATH>/@db2cli.lst blocking all
db2bind "%DB2PATH%\bnd\@db2cli.lst" blocking
권장하는 접근 방법은 런타임시 자동 바인드를 예방하기 위해 데이터베이스 작성시 이들 패키지를 항상 바인드하는 것입니다. 사용자에게 특권이 없거나 다른 응용프로그램이 동시에 자동 바인드를 시도하는 경우 자동 바인드가 실패할 수 있습니다.