13.15.4　例題４　RDエリアを年月単位に循環させて割り当てる場合（マトリクス分割の場合）

(a)　表分割ハッシュ関数p_rdb_dbhashを使用する方法

(i) 表分割ハッシュ関数の実行

HiRDBが提供する表分割ハッシュ関数を使用して，削除対象の2011年5月のデータが格納されているRDエリア名を特定します。表分割ハッシュ関数の引数を次に示します。なお，表分割ハッシュ関数については，マニュアル「HiRDB Version 9 UAP開発ガイド」を参照してください。

項番	引数	指定値
1	hashcode（ハッシュ関数コード）	p_rdb_HASH0(100)
2	ncol（分割キーの列数）	1
3	collst（分割キーの指定順序とデータ型コード，データ長コード）	データ型コード：PDSQL_CHAR データ長コード：8
4	dadlst（分割キーに格納するデータ）	項番3のデータ型の値
5	ndiv（表の分割数）	5
6	ncspace（HiRDBサーバで使用する各国文字の全角空白文字）	ncspace[0]：0x81 ncspace[1]：0x40
7	flags（空白変換レベル，DECIMAL型の符号正規化機能の使用有無）	0
8	rdno（分割条件指定順序，又は分割キー内通番）	なし

注

文字コード種別，空白変換レベル，及びDECIMAL型の符号正規化機能は，すべて省略しているものとします。

上記の表分割ハッシュ関数を実行すると，分割条件指定順序としてrdno=1が返ってきます。

(ii) SQLの実行

表分割ハッシュ関数の結果を基に，次のSQLを実行し，RDエリア名を特定します。

SELECT RDAREA_NAME,DCVALUES
    FROM MASTER.SQL_DIV_TABLE
      WHERE TABLE_SCHEMA='USER1'     /* ユーザ名 */
        AND TABLE_NAME='JUTYU'       /* ハッシュ分割表名 */
          AND MOD(DIV_NO-1,5)+1 = 1  /* RDエリア定義順序 */

上記のSQLを実行すると，次のように削除対象のRDエリア名としてRDA1及びRDA6が返ってきます。

 RDAREA_NAME                   DCVALUES※
 --------------------------    ----------------------
 RDA1                          100
 RDA6                          *********************

注※

DCVALUES列も同時に検索することによって，RDエリアが第1次元のどの分割に対応するかの情報も得られます。

(b)　CREATE PUBLIC FUNCTIONを定義しておく方法

(i) CREATE PUBLIC FUNCTIONの定義

ハッシュ関数HASH0の場合，次のSQLをあらかじめ定義しておくことでRDエリアを特定できます。

CREATE PUBLIC FUNCTION HASH0
 (DIVKEY VARCHAR(8)※,          /* ‘YYYYMMDD’ 又は ‘YYYYMM’ */
  NDIV INT)                    /* 分割列数 */
  RETURNS INT 
    BEGIN 
      DECLARE DIVDATE DATE; 
      SET DIVDATE = CASE LENGTH(DIVKEY)
             WHEN 6 THEN DATE(SUBSTR(DIVKEY,1,6)||'01','YYYYMMDD')
             ELSE DATE(DIVKEY,'YYYYMMDD')
             END;
  RETURN MOD(YEAR(DIVDATE)*12+MONTH(DIVDATE), NDIV)+1;    /* 戻り値 */
  END 
END_FUNC;

注※

列のデータはCHAR(8)ですが，パラメタはVARCHARでなければ文字列定数を指定した呼び出しができません。

(ii) SQLの実行

次のSQLで，2011年5月のデータがどこに入っているのかを検索します。

SELECT RDAREA_NAME,DCVALUES
  FROM MASTER.SQL_DIV_TABLE
    WHERE TABLE_SCHEMA='USER1'                   /* ユーザ名 */
      AND TABLE_NAME='JUTYU'                     /* ハッシュ分割表名 */
      AND MOD(DIV_NO-1,5)+1=HASH0('20110531',5)  /* RDエリア定義順序 */

上記のSQLを実行すると，次のように削除対象のRDエリア名としてRDA1及びRDA6が返ってきます。

 RDAREA_NAME                   DCVALUES※
 --------------------------    ----------------------
 RDA1                          100
 RDA6                          *********************

注※

DCVALUES列も同時に検索することによって，RDエリアが第1次元のどの分割に対応するかの情報も得られます。