CATP/1.1対応（スキーマバージョン）

1　概要

DBのスキーマ変更（フィールド新設）が行なわれた場合に、それに対応してい ないクライアントによりDBへのアクセスが行なわれると不都合が生じる可能性 がある。これに対処するためにCATPを改訂し、DBスキーマの実装レベル（以下、 DB実装レベル）を表わすスキーマバージョンを導入する。

2 CATPの改版

CATPを1.0から1.1へ改版する。仕様の変更点は表1の通り。

表1 CATP/1.0からCATP/1.1への変更点

3 サーバ実装仕様

各メソッドにおけるスキーマバージョン処理は表 2の通り。

表2 各メソッドにおけるスキーマバージョン処理

4 クライアントのスキーマバージョン取得

• 対象メソッド：

  GETHANDLE

• 概要：

  Schema-versionリクエストヘッダによって渡されるクライアントが実装するスキーマバージョンをハンドルバンドル情報として格納する。

• Schema-version ヘッダの仕様：

  Schema-version リクエストヘッダの仕様は 表3 の通り。

  表3 Schema-versionヘッダの仕様
  

  項番	項目	定義
  1	名前	Schema-version
  2	意味	クライアントの DB実装レベルを示す
  3	構文	ALL DIGIT（整数）
  4	制限値	1以上
  5	デフォルト値	1

• 処理仕様：

  クライアントのスキーマバージョンの取得は表4に従って行なう。

  表4　クライアントのDB実装レベル取得処理仕様
  

  項番	CATP バージョン	Schema-versionヘッダ	構文 チェック	意味 チェック	取得値	備考
  1	1.0	無し	?	?	1	デフォルト値
  2		有り	?	?	エラー	411 Invalid Request-Header value(Schema-version)
  3	1.1	無し	?	?	1	デフォルト値
  4		有り	NG	?	エラー	411 Invalid Request-Header value(Schema-version)
  5			OK	NG	エラー	411 Invalid Request-Header value(Schema-version)
  6			OK	OK	ヘッダ値

5 レコード登録チェック

• 対象メソッド：INSERT, UPDATE, SERVERPROCEDURECALL(ILL), DELETE
• 概要：レコードを新規・更新登録または削除する際に、対象レコード中にクライアン トが実装するスキーマバージョンを超えるフィールドが存在するかどうかチェッ クし、もし存在すれば実行不可としてエラーレスポンスを返す。
• チェック仕様：

  以下の条件を満たす場合のみ実行を許可する。

  Vc ≧ Vr

  ただし、

  Vc … クライアントのスキーマバージョン。ハンドルバンドル情報より取得。

  Vr … 対象レコードに含まれるフィールドの実装レベルの最大値。

  フィールドの実装レベルはサーバ内部に保持するフィールド定義より取得。

6 返送フィールドチェック

• 対象メソッド：SEARCH, SCAN, RETRIEVE, INSERT, UPDATE, SERVERPROCEDURECALL(ILL)
• 概要：レコードをクライアントへ返送する際に、クライアントのDB実装レベルを超え るフィールドが存在するかどうかチェックし、もし存在すれば返送レコードに はそのフィールドを含めない。
• チェック仕様：以下の条件を満たすフィールドのみ返送レコードに含める。

  Vc　≧　Vf

  ただし、

  Vc … クライアントのDB実装レベル。ハンドルバンドル情報より取得。

  Vｆ … フィールドの実装レベル。サーバ内部に保持するフィールド定義より取得。

7 クライアントのスキーマバージョン破棄

• 対象メソッド：RELEASEHANDLE
• 概要：

  ハンドルバンドル情報の破棄とともにクライアントの DB実装レベルも破棄する。

8 スキーマバージョン定義

2000年1月（運用開始）時点のスキーマバージョンの定義は 表5の通り。

表5 各フィールドの実装レベル定義 （ 2000年1月現在）