OpenESQL (既知の問題点)

OpenESQL の既知の問題および回避策について説明します。

コンパイル

CHECK または DB コンパイラ指令オプションを指定して、64 ビットのデータ ソース名 (Data Source Name; DSN) を 32 ビット プラットフォームに使用する OpenESQL アプリケーションをコンパイルするには、64 ビット DSN と同じ名前の 32 ビット DSN を明示的に作成する必要があります。これを行うには、ODBC Data Source Administrator (32 ビット) または ADO.NET Connection Editor を使用します。実行プロセスは、引き続き 64 ビット DSN を使用します。

リンク

表示数値型が XXXXXX として定義されている SQL ホスト変数を含む COBOL コードのコンパイル時に CHARSET(EBCDIC) を使用する場合は、リンク エラーを防止するためにoesqlebcライブラリにリンクする必要があります。

リンクを IDE から設定して再コンパイルするか、コンパイル後にコマンド プロンプトから必要なコマンドを実行することができます。

コンパイルまたは再コンパイル前に、IDE から次の手順を実行します。

  1. ソリューション エクスプローラーで、プロジェクトに表示されている [Properties] エントリをダブルクリックします。
  2. [COBOL Link] タブで、[Link with libs] フィールドに対応するブラウズ ボタン (ブラウズ) をクリックします。
  3. installDir\lib ディレクトリをブラウズします。ここで、installDir は Enterprise Developer のインストール場所のパスで、デフォルトでは %ProgramFiles(x86)%\Rocket Software\Enterprise Developer です。
  4. oesqlebc.lib をダブルクリックして選択し、フィールドに値を入力します。
  5. 保存 をクリックして変更内容を保存します。

コンパイル後に、コマンド プロンプトから次の手順を実行します。

  1. Enterprise Developer コマンド プロンプトを起動します。手順については、「Enterprise Developer コマンド プロンプトを起動するには」を参照してください。
  2. コマンド プロンプトで、COBOL コードが格納されているディレクトリに切り替えます。
  3. 次のコマンドを連続して入力します。 
    set lib=installDir\lib;%lib% cbllink myapp.obj oesqlebc.lib
    ここで、installDir は Enterprise Developer のインストール場所のパスで、デフォルトでは %ProgramFiles(x86)%\Rocket Software\Enterprise Developer です。myapp は COBOL オブジェクト ファイルの名前です。

埋め込み SQL 文

1 つまたは複数の特殊文字が含まれているテーブル名または列名を指定する EXEC SQL 文では、プリプロセッサ エラーを防止するためにそのテーブル名または列名を引用符で囲む必要があります。特殊文字は、128 よりも大きい値を持つ ASCII 文字、または x"80" よりも大きい値を持つ 16 進文字です。

MySQL

  • ODBC でのみサポートされます。
  • OpenESQL はスクロール可能なカーソルをサポートしていません。
  • OpenESQL では、MySQL の _rowid フィールドを使用して、カーソルでの位置指定更新および位置指定削除の使用をサポートします。_rowid フィールドは、一意制約または整数列の主キーを使用してテーブルが定義されている場合にのみ MySQL で使用できます。
    注：テーブルが一意制約または整数列の主キーを使用して定義されていない場合は、EXEC SQL UPDATE/DELETE WHERE CURRENT OF 文を対応する検索対象の EXEC SQL UPDATE/DELETE 文に置き換える必要があります。
  • MySQL の行が更新されても行の内容は変更されない場合、MySQL では、影響を受ける行数について、他の DBMS から通常返される 1 ではなく、0 (ゼロ) を返すことがあります。この問題を回避するには、MySQL ODBC ドライバーの構成オプションを次のように変更することを検討してください。
    1. MySQL/Connector/ODBC データ ソース構成を呼び出します。
    2. [Cursors/Results] をクリックします。
    3. [Return matched rows instead of affected rows] をオンにします。
  • MySQL 5.7 と ODBC 5.3 ドライバーを使用する場合、次の制限が適用されます。
    • 修飾されていない SELECT * 文では、プロジェクション リストに他の項目を含めることはできません
    • ODBC エスケープ シーケンスは認識されません
    • MySQL では、1 つの SQL 文に対する、またはトランザクション限界内の複数の SQL 文に対する遅延制約チェックは許可されません
    • SQL TYPE BLOB ホスト変数の長さは 3M バイトに制限されています

ODBC

Oracle の ODBC ドライバーを使用しているときに、配列フェッチといくつかのスクロール フェッチで、フェッチ操作間に配列サイズを変更すると不一致が発生することがあります。この問題を克服するには、SQL(NORESULTARRAY) を使用してアプリケーションをビルドします。これを設定した場合、OpenESQL は単一行フェッチを隠れて実行し、この制限を回避します。

OpenESQL ODBC ネイティブ ランタイム

現在は、OpenESQL で BEHAVIOR コンパイラ指令が暗黙的に OPTIMIZED に設定されるようになったため、OpenESQL アプリケーションはデフォルトでパフォーマンスの最適化が行われます。旧製品では、BEHAVIOR コンパイラ指令は暗黙的に UNOPTIMIZED に設定されていました。この変更は、プログラムの動作に次のように影響する可能性があります。

  • SET SCROLLOPTION または SET CONCURRENCY EXEC SQL 文を含むプログラムのコンパイルに失敗します。この変更の影響を受けるプログラムについては、次のいずれかの操作を行ってください。
    • コンパイルする前に、BEHAVIOR コンパイラ指令を UNOPTIMIZED に設定します。これは最も単純な解決策ですが、パフォーマンスが低下する可能性があるため、この方法で解決することは推奨されません。
    • すべての SET SCROLLOPTION および SET CONCURRENCY 文を削除し、必要であれば DECLARE CURSOR 文を変更して、同じ動作になるように適切なパラメーターを含めます。たとえば、SET SCROLLOPTION 文と同じ動作を引き出すには、次の DECLARE CURSOR 文を使用します。 
      EXEC SQL DECLARE cursorname SCROLL LOCK CURSOR FOR…

      デフォルトでは、カーソルは順方向で読み取り専用です。これが望ましい動作である場合は、別途の処理なしで SET 文を安全に削除できます。ただし、適切な方法として、デフォルト動作が常に明示的になるように FOR READ ONLY または FOR UPDATE をカーソル宣言に含めるようにすることをお勧めします。Rocket Software では、この解決策をお勧めしていました。

  • OPTIMIZED 設定では、未確定カーソルが更新可能になりません。そのため、埋め込み SQL のデフォルト ANSI 規格に従ってカーソルが更新可能であると見なすアプリケーションは影響を受けます。この場合は、BEHAVIOR コンパイラ指令オプションを ANSI に設定することをお勧めします。
  • OPTIMIZED 設定では、スクロール可能なカーソルは想定されていません。そのため、カーソルがスクロール可能であると見なすアプリケーションは影響を受けます。この場合は、上記のように DECLARE CURSOR 文を変更して補正することをお勧めします。
重要：このように暗黙動作が変更されたことによって得られるパフォーマンスの向上を利用しない場合は、OpenESQL 構成ユーティリティを使用して、BEHAVIOR コンパイラ指令の暗黙値を UNOPTIMIZED に戻します。詳細については、「OpenESQL での埋め込み SQL カーソルの動作とパフォーマンス」を参照してください。

PostgreSQL に関する推奨事項

  • PostgreSQL は、PIC X ホスト変数の NULL の date、time、または timestamp 値を受け付けません。SQL で CAST(:hostvar as TIMESTAMP) を使用するか、アプリケーションで SQL TYPE TIMESTAMP を使用する必要があります。
  • PostgreSQL では、埋め込み NULL 文字は binary 列でのみサポートされ、character 列ではサポートされません。
  • MBDT SQLTUB の ODBC で PostgreSQL を使用する場合、ODBC ドライバーのデフォルトの動作が変更されない限り、PostgreSQL は bytea データ型を LongVarBinary または BLOB にマップします。
  • PostgreSQL と ODBC を併用する場合に、呼び出し元アプリケーションに負の SQL コードが返された際は、ODBC ドライバーのデフォルトの動作を変更しない限り、PostgreSQL によってトランザクションが暗黙的に中止されます。さらに、PostgreSQL では ODBC API 呼び出し SQLSetPos がサポートされず、更新可能カーソルのパフォーマンスが低下します。

    この問題を回避するには、psqlODBC ドライバーの構成オプションを変更することを検討してください。これを行うには、次の手順を使用します。

    1. [PostgreSQL ANSI or UNICODE ODBC Driver (psqlODBC) Setup] ダイアログ ボックスを起動します。
    2. [Datasource] をクリックします。
    3. [Advanced Options] の 1 ページ目で、[Use Declare/Fetch] をオンにします。
    4. [Page 2] をクリックします。
    5. [Advanced Options] の 2 ページ目で、[Level of rollback on errors] オプションを [Statement] に設定し、[Updatable Cursors] をオフにします。
    6. 上記の 3 番目の箇条書きで説明した動作を解決するには、[bytea as LOG] をオフにします。
  • OpenESQL では、PostgreSQL の oid フィールドを使用して、FOR UPDATE カーソルの使用をサポートします。PostgreSQL バージョン 12 以降では、内部 oid 列は非推奨になりました。したがって、PostgreSQL バージョン 12 以降で FOR UPDATE カーソルを使用するには、まず oid という名前の ID 列を追加する必要があります。次に例を示します。 
    EXEC SQL alter table table-name add column oid smallint generated always as identity END-EXEC
    注：返された oid フィールドを考慮して、これらのテーブルからの既存の SELECT * FETCH 文も更新する必要があります。
関連作業
Enterprise Developer コマンド プロンプトを起動するにはEnterprise Developer コマンド プロンプト