3.1.3 ホスト変数および標識変数の指定方法

Symfoware Server アプリケーション開発ガイド(埋込みSQL編) - FUJITSU -

目次索引

3.1.3 ホスト変数および標識変数の指定方法

ホスト変数は、アプリケーションとデータベースの間でデータの受渡しをするのに使用する変数です。SQL文中でホスト変数と対にして指定し、データの内容がNULL値かどうかを表すために使用する変数を、標識変数と呼びます。アプリケーションで参照するデータをデータベースから取り出す場合、標識変数には、取り出したデータがNULL値かどうかを表す情報が設定されます。逆に、アプリケーションで設定したデータをデータベースに格納する場合には、標識変数には、格納するデータがNULL値かどうかを表す情報を設定しておきます。標識変数は、埋込みSQL宣言節で宣言します。宣言の記述方法はホスト変数と同じです。なお、標識変数のデータ型はSQLのSMALLINTに対応するデータ型であることが必要です。

各ホスト言語でのデータ型と、SQLのデータ型との対応については、“SQLリファレンス”を参照してください。

ホスト変数および標識変数をSQL文中に指定する場合には、変数の前にコロン“:”を付けて指定します。以下にその指定例を示します(ゴシック部がホスト変数または標識変数です)。ただし、SQL文以外の、C言語のステートメント中では、一般のC言語の変数と同じで、コロン“:”は付けません。

標識変数には、SQL文の処理結果が以下のように格納されます。

取り出すデータがNULL値の場合、標識変数には、-1が格納されます。
取り出すデータのデータ型が文字列または各国語文字列で、かつNULL値ではなく、取り出すデータの長さが相手指定の文字列または各国語文字列の長さよりも長い場合は、取り出すデータの有効な長さが標識変数に格納されます。
取り出すデータの有効な長さが32,000バイトを超える場合は、標識変数に0または32,000が格納されます。
上記以外の場合は、標識変数に0が格納されます。

なお、標識変数を指定していない場合、取り出すデータがNULL値になると、SQL文の処理はエラーになります。

例1

ホスト変数の指定例
STOCKおよびHOUSEをホスト変数、QFLAGをSTOCKの標識変数、そして、WFLAGをHOUSEの標識変数として指定します。SQL文中にホスト変数および標識変数を指定する場合は、コロン“:”を付けます。
EXEC SQL SELECT 在庫数量，倉庫番号
     INTO :STOCK  INDICATOR :QFLAG,
          :HOUSE  INDICATOR :WFLAG
      FROM 在庫表 WHERE  製品番号 = 110;

例2

SQL文以外のC言語のステートメント上のホスト変数の指定例
STOCKをホスト変数、QFLAGをSTOCKの標識変数として使用しています。C言語のステートメントでは、これらの変数にコロン“:”は付けません。
EXEC SQL FETCH CU1 INTO :STOCK INDICATOR :QFLAG;
if( QFLAG == -1) goto p_null ;
if( STOCK == 0) goto p_loop ;

■ホスト変数を使用する場合の注意事項

文字列型または各国語文字列型の場合、NULL文字(\0)はデータ受渡しの対象にはなりません。そのため、アプリケーションで文字列の終わりを認識するような処理を行う場合、NULL文字を設定しなければなりません。以下に例を示します。

SQLSTATE[5]='\0';
printf( "SQLSTATE:%s\n" , SQLSTATE );

■ホスト変数へ入出力するデータの文字コード系の考慮

ホスト変数へ入出力するデータの文字コード系がSymfoware/RDBの文字コード系と異なる場合は、そのホスト変数に格納するデータの文字コード系を、クライアント用の動作環境ファイルまたは環境変数に設定します。

以下に、ホスト変数へ入出力するデータの文字コード系がSymfoware/RDBの文字コード系と異なる場合の例、および、ホスト変数へ入出力するデータの文字コード系とSymfoware/RDBの文字コード系が同じ場合の例を示します。

例1

ホスト変数へ入出力するデータの文字コードとSymfoware/RDBの文字コード系が異なる場合
以下の例では、Symfoware/RDBの文字コード系がシフトJISコード、また、SELECT文(1)でホスト変数に格納されたデータの文字コード系がUNICODEであるとします。そして、このデータを格納するデータベースの文字コード系はUNICODEであるとします。

この場合、クライアント用の動作環境ファイルまたは環境変数には、ホスト変数に格納されているデータがUNICODEであることを示すパラメタを設定します。設定するパラメタについての詳細は、“クライアント用の動作環境ファイルの作成”を参照してください。

こうすることによって、サーバでのコード変換の必要がなくなります。
EXEC SQL BEGIN DECLARE SECTION;
  char    SQLSTATE[6];
  char    SQLMSG[256];
           :
  char CHARACTER SET NCHAR    H1[10];
EXEC SQL END DECLARE SECTION;
           :
memset(H1,'\0',sizeof(H1));
EXEC SQL SELECT COL1 INTO :H1 FROM S1.T0 WHERE COL0=3;    …… (1)
EXEC SQL INSERT INTO S1.T1 VALUES(3,:H1);                 …… (2)
(1) データベースよりUNICODEなどのSymfoware/RDBの文字コード系と異なるコードのデータが取得できます。

(2) 上記のSELECT文で取得したデータのコードのまま、INSERT文が実行できます。このように、アプリケーションにおいて、Symfoware/RDBの文字コード系と異なるコード系のデータが操作可能です。

例2

ホスト変数へ入出力するデータの文字コードがSymfoware/RDBの文字コード系と同じ場合
以下の例では、Symfoware/RDBの文字コード系がシフトJISコードであるとします。この場合、ホスト変数に入出力するデータの文字コード系はシフトJISコードになります。
EXEC SQL BEGIN DECLARE SECTION;
  char    SQLSTATE[6];
  char    SQLMSG[256];
           :
  char CHARACTER SET NCHAR    H1[10];
EXEC SQL END DECLARE SECTION;
           :
memset(H1,'\0',sizeof(H1));
memcpy(H1,"日本語",6);                            …… (1)
EXEC SQL INSERT INTO S1.T1 VALUES(:H1);           …… (2)
(1) Symfoware/RDBの文字コード系の“日本語”がホスト変数H1に格納されます。

(2) Symfoware/RDBの文字コード系の“日本語”でINSERT文を実行します。このように、Symfoware/RDBの文字コード系を使用してデータ操作を行う場合に適しています。

■64ビット環境でのホスト変数の扱い

64ビットで実行するアプリケーションでは、ホスト変数にlong型を指定した場合、-2147483648～2147483647以外の値は入力できません。-2147483648～2147483647以外の値を入力した場合は、実行時にエラーになります。

■マルチスレッド環境でのホスト変数の宣言

マルチスレッド環境で実行するアプリケーションでは、ホスト変数にはauto変数を使用することを推奨します。extern変数およびstatic変数などを使用した場合は、スレッド間でホスト変数が共有されるため、複数のスレッドから同時にデータベースをアクセスすると、参照および更新が正しくできない場合があります。extern変数およびstatic変数などを使用する場合は、セマフォを利用するなどして、並列に動作するスレッド間の排他制御を考慮したアプリケーションを作成してください。

セマフォの詳細については、OSのシステム関数について説明されているマニュアルを参照してください。

目次索引