PSQL v13 R2 の新機能

このドキュメントは、リリース後にも更新される可能性があります。最新バージョンは、弊社 Web サイトからダウンロードできます。

PSQL v13 R2 エンジンは新しいファイル形式をサポートします。このファイル形式ではファイルサイズの制限が 64 TB まで拡張され、レコード数の増加も 40 億個を超えます。新しいファイル形式のバージョンは 13.0 と呼ばれます。

9.5 形式ファイルで許容されるファイルサイズとレコード数から拡張された 13.0 形式ファイルにフルアクセスするには、アプリケーションで、Btrieve の新しいエントリポイントの組み合わせ BTRVEX と BTRVEXID を使用し、8 バイトレコードアドレスを扱えるようにしておく必要があります。

既存の BTRV または BTRCALL エントリポイントを使用するアプリケーションは、引き続き 4 バイトレコードアドレスを使用し、9.5 および 13.0 形式ファイルはいずれも 9.5 形式における上限を使用できます。未変更の BTRV アプリケーションは、オペレーションが明示的なレコードアドレスを要求しない限り、9.5 形式の制限よりも大きい 13.0 形式ファイルにアクセスすることもできます。

PSQL v13 R2 エンジンのデフォルトのファイル形式の設定は 9.5 のままです。

13.0 形式のファイルは 2 GB のセグメント化をサポートしません。

PSQL の異なるバージョンが混在している環境では、以下の事項が当てはまります。

•13.0 形式ファイルが 9.5 以前の形式の 256 GB サイズ制限以下である場合は、PSQL v13 SP2 またはそれ以前のクライアントは、PSQL v13 R2 エンジン上でその 13.0 形式ファイルにアクセスできる。

•PSQL v13 SP2 以前のキャッシュエンジンまたはクライアントレポートエンジンは、ファイルサイズにかかわらず 13.0 形式のファイルを開くことはできない。

•PSQL v13 R2 キャッシュエンジンまたはクライアントレポートエンジンは、PSQL v13 SP2 以前のエンジン上のファイルを開くことはできない。

新しい BTRVEX エントリポイントは最大 252 KB のデータバッファをサポートします。古い BTRV および BTRVCALL エントリーポイントは、64 KB 未満のデータバッファに制限されています。バッファーサイズが大きくなったことは、特に Extended Get オペレーションや Insert オペレーションで有用です。これらのオペレーションはレコードアドレスを伴うので、それらを BTRVEX に変換する場合はデータバッファーのレイアウト変更を考慮しなければいけません。

Get Direct Chunk のディスクリプターは 64 KB に制限されていますが、1 個の大きなデータバッファーに複数の 64 KB チャンクを要求することができます。

13.0 形式のファイルのサイズが大きくなる可能性がある場合、およびより大きなデータバッファーを使用する場合、以前の Btrieve インターフェイスが提供していたものより大きなランタイム値が必要となります。PSQL 13 R2 では BTRVEX と BTRVEXID という 2 つの新しいエントリポイントを導入しています。これらは BTRCALL および BTRCALLID とよく似ていますが、いくつかの関数の引数のデータ型の幅が広くなっている点と、いくつかのデータバッファーのレイアウトが異なっている点が違います。宣言は btrvexid.h 内にあり、実装は BTRCALL と同じファイル内にあります。新しいエントリポイントの使用に関する詳細は、最新の SDK と『Btrieve API Guide』を参照してください。

BTRVEX エントリポイントを使用する Btrieve オペレーションの場合、データバッファーで渡される一部の値は、8 バイトのレコードアドレスやレコードカウントのように幅が広くなっています。8 バイト動作は BTRVEX エントリポイントに起因するものであり、アクセスするファイルのファイル形式によって決まることでないことに留意してください。次のオペレーションは、データバッファーのレイアウトの変更を必要とします。

エントリポイントの選択は、レコードデータには影響しません。

上述のとおり、データバッファーサイズの引数は BTRCALL が 16 ビット整数を使用する箇所が BTRVEX では 32 ビット整数へのポインターになっています。このため、データバッファーを 64 KB より大きくすることができます。

新しいファイル形式へ移行する場合、ポジションブロックとクライアント ID の値は BTRCALL と BTRVEX の両方で使用できるため、すべてのコードを一度に BTRVEX に変換する必要はないことを覚えておいてください。

BTRVEX のキー番号の引数は 32 ビット整数であるのに対し、BTRCALL は 8 ビットの符号付き整数を使用します。既存のコードを BTRVEX へ簡単に変換するためには、BTRVEX エントリポイントはキー値 128 ～ 255 を -128 ～ -1 に再マップします。これは、符号付きバイト（例：-2）としてでなく符号なしバイト（例：0xFE）として指定された定数に対応します。

BTRVEX を使用する PSQL v13 R2 クライアントアプリケーションは、PSQL v13 SP2 以前のエンジンにアクセスできます。ただし、明示的なレコードアドレスまたは拡張したデータ構造を伴うオペレーションはステータスコード 137 API 不一致エラーで失敗します。

13.0 ファイル形式では長いオーナーネームの暗号化に AES-192 を使用します。

INSERT ステートメントは ON DUPLICATE KEY UPDATE 句で拡張されています。これは一般に “upsert” として知られている動作を実装します。挿入された行が、既にテーブル内にある一意のキーと一致する場合、その行に対して ON DUPLICATE KEY 句が実行されます。UPDATE 句は古い値と新しい値の両方にアクセスできます。

たとえば、以下のクエリは新しいキーを持つ行を挿入し、既存のキーを持つ行の値とマージします。

挿入が更新に変更された場合、更新を行う前に挿入トリガーがすべてロールバックされます。

PSQL v13 R2 Reporting Engine はリモート SQL クライアントをサポートし、それらクライアントのライセンスをストレージエンジン上で管理できるようになりました。