同じプログラム内の組み込み SQL と Db2 ODBC

組み込み静的 SQL と Db2® ODBC を組み合わせて、混合アプリケーションを作成することができます。64 ビット・アプリケーションの場合、組み込み静的 SQL ステートメントを使用することはできません。

混合アプリケーションを用いると、Db2 ODBC 関数が備えている使いやすさと、 組み込み SQL が提供するパフォーマンス向上という両方の利点を生かすことができます。

重要: Db2 ODBC と組み込み SQL を混合使用する場合は、 複数コンテキストの Db2 ODBC サポートを有効にしないでください。 混合使用するアプリケーションの初期化ファイルでは、MULTICONTEXT=0 を指定するか、 キーワード MULTICONTEXT を除外する必要があります。
アプリケーションで Db2 ODBC と組み込み SQL を混合使用する場合、 これらのインターフェースを組み合わせる上で、以下のような制限があります。
  • Db2 ODBC もしくは組み込み SQL のいずれか一方のみを用いて、すべての接続管理 とトランザクション管理を実施してください。同じインターフェースを用いて、すべての接続、 コミット、およびロールバックを行う必要があります。
  • 各照会ステートメントごとに、1 つのインターフェース (Db2 ODBC または組み込み SQL) のみ を使用してください。 例えば、アプリケーションは、組み込み SQL ルーチンでカーソルをオープンして、 その後、Db2 ODBC SQLFetch() 関数を呼び出して行データを取り出すことはできません。

Db2 ODBC では複数接続が許可されているため、組み込み SQL で作成されたルーチンを 呼び出す前に、SQLSetConnection() を呼び出す必要があります。SQLSetConnection() では、組み込み SQL ルーチンを実行させる接続を明示的に指定することができます。アプリケーションが単一接続のみを行う場合、あるいはアプリケーション全体を Db2 ODBC で作成した場合 は、SQLSetConnection() 呼び出しを組み込む必要はありません。

ヒント: 混合アプリケーションを作成する場合は、このアプリケーションを分割して、関数呼び出しを独立して 行うメインプログラムにします。 組み込み SQL を用いて作成された関数を呼び出す 1 つの Db2 ODBC アプリケーションとして、 あるいは Db2 ODBC を用いて作成された関数を呼び出す 1 つの組み込み SQL アプリケーションとして、 混合アプリケーションを構成してください。このような構成によって、メインプログラムで トランザクション管理を別個に行うことができ、一方では単一インターフェースで作成された 個々の関数の中で照会ステートメントを作成できます。Db2 ODBC を用いて作成された関数は、NULL 接続を使用する必要があります。
以下の例は、2 つのデータ・ソースに接続し、Db2 ODBC を使用して組み込み SQL と動的 SQL の両方を実行するアプリケーションを示しています。
図 1. 組み込み SQL および動的 SQL を混合使用するアプリケーション
/* ... */
    /* Allocate an environment handle   */
    SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
    /* Connect to first data source */
    DBconnect(henv, &hdbc[0]);
    /* Connect to second data source */
    DBconnect(henv, &hdbc[1]);
    /*********   Start processing step  *************************/
    /* NOTE: at this point two connections are active */
    /* Set current connection to the first database */
    if ( (rc = SQLSetConnection(hdbc[0])) != SQL_SUCCESS )
         printf("Error setting connection 1¥n");
    /* Call function that contains embedded SQL */
    if ((rc = Create_Tab() ) != 0)
         printf("Error Creating Table on 1st connection, RC=
   /*  Commit transaction on connection 1 */
    SQLEndTran(SQL_HANDLE_DBC, hdbc[0], SQL_COMMIT);
    /* set current connection to the second database */
    if ( (rc = SQLSetConnection(hdbc[1])) != SQL_SUCCESS )
         printf("Error setting connection 2¥n");
    /* call function that contains embedded SQL */
    if ((rc = Create_Tab() ) != 0)
         printf("Error Creating Table on 2nd connection, RC=
   /*  Commit transaction on connection 2 */
    SQLEndTran(SQL_HANDLE_DBC, hdbc[1], SQL_COMMIT);
    /* Pause to allow the existance of the tables to be verified. */
    printf("Tables created, hit Return to continue¥n");
    getchar();
    SQLSetConnection(hdbc[0]);
    if (( rc = Drop_Tab() ) != 0)
        printf("Error dropping Table on 1st connection, RC=
   /*  Commit transaction on connection 1 */
    SQLEndTran(SQL_HANDLE_DBC, hdbc[0], SQL_COMMIT);
    SQLSetConnection(hdbc[1]);
    if (( rc = Drop_Tab() ) != 0)
        printf("Error dropping Table on 2nd connection, RC=
   /*  Commit transaction on connection 2 */
    SQLEndTran(SQL_HANDLE_DBC, hdbc[1], SQL_COMMIT);
    printf("Tables dropped¥n");
    /*********   End processing step  ***************************/
/* ... */
/*************   Embedded SQL functions  *******************************
** This would normally be a separate file to avoid having to           *
** keep precompiling the embedded file in order to compile the DB2 CLI *
** section50                                                           *
************************************************************************/
EXEC SQL INCLUDE SQLCA;
int
Create_Tab( )
{
   EXEC SQL CREATE TABLE mixedup
            (ID INTEGER, NAME CHAR(10));
   return( SQLCODE);
}
int
Drop_Tab( )
{
   EXEC SQL DROP TABLE mixedup;
   return( SQLCODE);
}
/* ... */