sqlAccessColumnsAsBytes ビルド記述子オプションは、DB2 データベースからの列値を、Java オブジェクトの構成に使用するのではなく SQL レコードにバイトとして直接コピーするかどうかを指定します。
このオプションを YES に設定すると、生成される Java コードでパフォーマンスが向上します。ただし、以下の場合にのみ向上させることができます。
- DB2 JDBC ドライバーが、バイト・アクセス API をサポートしている。この説明の作成時点では、準拠するドライバーは JCC バージョン 3.62/4.12 用の JCC Type 2 zos ドライバーのみです。
- 列値の型が 10 進数、文字、またはグラフィックである。これには、char、varchar、longvarchar、graphic、vargraphic、および long vargraphic が含まれます。
- SQL レコードの fieldsMatchColumns プロパティーが YES に設定されている。このプロパティーの詳細については、『SQLRecord ステレオタイプ』を参照してください。
- データベース・エンコードが、Java ランタイム環境の file.encoding プロパティーの値と同じである。
パフォーマンスが最も向上するのは、レベル番号のあるパーツに基づく SQL レコードの場合です。この番号は、レコードが構造化されていて生成時にフィールド長が固定されることを意味します。
ただし、非構造化 SQL レコードでもパフォーマンスは向上します。
値
- NO (デフォルト)
- 列値は、Java オブジェクトを構成するために使用され、バイトとしてコピーされません。
- YES
- 可能な場合、列値はバイトとしてコピーされます。