1 つ以上のデータ・ソースに接続する方法
Db2® は、DRDA によるリモート・データ・ソースへの別の接続タイプをサポートします。
アプリケーションが CONNECT (タイプ 1) であり、かつ MULTICONTEXT=0 を 指定している場合は、Db2 ODBC を使ってそのアプリケーションは論理的に 複数の データ・ソースへ接続することができます。ただし、Db2 ODBC は、アクティブ接続でのアプリケーションでは、 未解決トランザクション (アプリケーションがまだコミットしていない、またはロールバック していないトランザクション) は 1 つしか認めていません。 アプリケーションが CONNECT (タイプ 2) の場合、トランザクションは分散作業単位となり、 すべてのデータ・ソースは、トランザクションの処理 (コミットまたはロールバック) に関与します。
1 つ以上のデータ・ソースに同時に接続するためには、各接続ごと に 1 回、SQLAllocHandle() (HandleType を SQL_HANDLE_DBC に設定) を呼び出します。このステートメントが SQLConnect() 呼び出しで引き渡す接続ハンドルを使用して、 データ・ソース接続を要求します。SQLAllocHandle() 呼び出し (HandleType を SQL_HANDLE_STMT に設定) で、 同じ接続ハンドルを使用してステートメント・ハンドルを割り振り、その接続内で使用します。拡張接続関数 SQLDriverConnect() によって、追加の接続属性を設定することができます。しかし異なる接続で実行するステートメントは調整を行いません。
例: 以下の例 は、接続し、 ハンドルを割り振り、ハンドルを解放し、切断するアプリケーションを示しています。このアプリケーションは、複数のデータ・ソースに接続しますが、明示的に接続タイプを 設定したり、複数コンテキスト・サポートを指定することはありません。 初期化ファイルの CONNECTTYPE および MULTICONTEXT キーワードが、これらの設定を宣言します。
/* ... */
/*******************************************************
** - Demonstrate basic connection to two data sources.
** - Error handling mostly ignored for simplicity
**
** Functions used:
**
** SQLAllocHandle SQLDisconnect
** SQLConnect SQLFreeHandle
** Local Functions:
** DBconnect
**
********************************************************/
#include <stdio.h>
#include <stdlib.h>
#include "sqlcli1.h"
int
DBconnect(SQLHENV henv,
SQLHDBC * hdbc,
char * server);
#define MAX_UID_LENGTH 18
#define MAX_PWD_LENGTH 30
#define MAX_CONNECTIONS 2
int
main( )
{
SQLHENV henv;
SQLHDBC hdbc[MAX_CONNECTIONS];
char * svr[MAX_CONNECTIONS] =
{
"KARACHI" ,
"DAMASCUS"
}
/* Allocate an environment handle */
SQLAllocHandle( SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
/* Connect to first data source */
DBconnect(henv, &hdbc[0],
svr[0]);
/* Connect to second data source */
DBconnect(henv, &hdbc[1],
svr[1]);
/********* Start processing step *************************/
/* Allocate statement handle, execute statement, and so on */
/********* End processing step ***************************/
/************************************************************/
/* Commit work on connection 1. */
/************************************************************/
SQLEndTran(SQL_HANDLE_DBC, hdbc[0], SQL_COMMIT);
/************************************************************/
/* Commit work on connection 2. This has NO effect on the */
/* transaction active on connection 1. */
/************************************************************/
SQLEndTran(SQL_HANDLE_DBC, hdbc[1], SQL_COMMIT);
printf("¥nDisconnecting .....¥n");
SQLDisconnect(hdbc[0]); /* disconnect first connection */
SQLDisconnect(hdbc[1]); /* disconnect second connection */
SQLFreeHandle (SQL_HANDLE_DBC, hdbc[0]); /* free first connection handle */
SQLFreeHandle (SQL_HANDLE_DBC, hdbc[1]); /* free second connection handle */
SQLFreeHandle(SQL_HANDLE_ENV, henv); /* free environment handle */
return (SQL_SUCCESS);
}
/********************************************************************
** Server is passed as a parameter. Note that NULL values are **
** passed for USERID and PASSWORD. **
********************************************************************/
int
DBconnect(SQLHENV henv,
SQLHDBC * hdbc,
char * server)
{
SQLRETURN rc;
SQLCHAR buffer[255];
SQLSMALLINT outlen;
SQLAllocHandle(SQL_HANDLE_DBC, henv, hdbc); /* allocate connection handle */
rc = SQLConnect(*hdbc, server, SQL_NTS, NULL, SQL_NTS, NULL, SQL_NTS);
if (rc != SQL_SUCCESS) {
printf(">--- Error while connecting to database:
return (SQL_ERROR);
} else {
printf(">Connected to
return (SQL_SUCCESS);
}
}
/* ... */