Db2 ODBC アプリケーションでの特殊タイプ

特殊タイプ と呼ばれる、ユーザー独自の SQL データ・タイプを定義できます。特殊タイプを作成する場合、既存の SQL 組み込みタイプを基礎として特殊タイプを作成します。この SQL 組み込みタイプは、ソース・タイプ と呼ばれます。

内部的には、特殊タイプとソース・タイプは同等ですが、多くのプログラミング上の操作では、 特殊タイプとソース・タイプは互換性がありません。 特殊タイプは、CREATE DISTINCT TYPE SQL ステートメントを用いて作成します。

特殊タイプは、オブジェクト指向のプログラムで必要となる強力なタイプ制御に役立ちます。特殊タイプを使用する場合、特殊タイプで明示的に定義された関数と演算子のみを そのタイプのインスタンスに確実に適用することができます。特殊タイプを使用する場合、アプリケーションは引き続き C データ・タイプをアプリケーション変数で処理します。SQL ステートメントを構成する 場合は、特殊タイプだけを考慮する必要があります。

特殊タイプに適用されるガイドラインを以下に示します。
  • ソース・タイプに適用される、SQL から C データ・タイプ への変換規則はすべて、特殊タイプにも適用されます。
  • 特殊タイプには、ソース・タイプと同じデフォルトの C タイプがあります。
  • SQLDescribeCol() は、特殊タイプ列のソース・タイプを戻します。SQL_DESC_DISTINCT_TYPE を設定した入力記述子タイプを指定して SQLColAttribute() を 呼び出し、特殊タイプ名を取得します。
  • 特殊タイプをあるパラメーターに対して比較する SQL 述部を使用する場合、そのパラメーター・マーカー を特殊タイプにキャストするか、特殊タイプをソース・タイプにキャストする必要があります。 このキャストが必要な理由は、特殊タイプが比較演算で他のデータ・タイプと互換性がないからです。 アプリケーションは、SQL に組み込まれたタイプを表す C データ・タイプのみを使用します。この C タイプと SQL タイプの違いのため、C 組み込みタイプから SQL ステートメント内 の SQL 特殊タイプにキャストする必要があります。別の方法としては、C タイプがサポートする ソース・タイプに対して、特殊タイプをキャストすることができます。 これらの変換のいずれも行わない場合は、ステートメントを準備する際にエラーを生じます。

以下の例 は、特殊タイプ、ユーザー定義関数、および特殊タイプ列を含む表を作成するアプリケーションを示しています。

図 1. 特殊タイプを作成するアプリケーション
/* ... */
    /* Initialize SQL statement strings  */
    SQLCHAR         stmt[][MAX_STMT_LEN] = {
        "CREATE DISTINCT TYPE CNUM AS INTEGER WITH COMPARISONS",
        "CREATE DISTINCT TYPE PUNIT AS CHAR(2) WITH COMPARISONS",
        "CREATE DISTINCT TYPE UPRICE AS DECIMAL(10, 2) ¥
            WITH COMPARISONS",
        "CREATE DISTINCT TYPE PRICE AS DECIMAL(10, 2) ¥
            WITH COMPARISONS",
        "CREATE FUNCTION PRICE (CHAR(12), PUNIT, char(16) ) ¥
            returns char(12) ¥
              NOT FENCED EXTERNAL NAME 'order!price' ¥
              NOT VARIANT NO SQL  LANGUAGE C PARAMETER STYLE DB2SQL ¥
              NO EXTERNAL ACTION",
        "CREATE DISTINCT TYPE PNUM AS INTEGER WITH COMPARISONS",
        "CREATE FUNCTION ¥"+¥" (PNUM, INTEGER) RETURNS PNUM ¥
            source sysibm.¥"+¥"(integer, integer)",
        "CREATE FUNCTION MAX  (PNUM) RETURNS PNUM ¥
            source max(integer)",
     "CREATE DISTINCT TYPE ONUM AS INTEGER WITH COMPARISONS",
     "CREATE TABLE CUSTOMER ( ¥
Cust_Num     CNUM NOT NULL, ¥
First_Name   CHAR(30) NOT NULL, ¥
Last_Name    CHAR(30) NOT NULL, ¥
Street       CHAR(128) WITH DEFAULT, ¥
City         CHAR(30) WITH DEFAULT, ¥
Prov_State   CHAR(30) WITH DEFAULT, ¥
PZ_Code      CHAR(9) WITH DEFAULT, ¥
Country      CHAR(30) WITH DEFAULT, ¥
Phone_Num    CHAR(20) WITH DEFAULT, ¥
PRIMARY KEY  (Cust_Num) )",
        "CREATE TABLE PRODUCT ( ¥
Prod_Num     PNUM NOT NULL, ¥
Description  VARCHAR(256) NOT NULL, ¥
Price        DECIMAL(10,2) WITH DEFAULT , ¥
Units        PUNIT NOT NULL, ¥
Combo        CHAR(1) WITH DEFAULT, ¥
PRIMARY KEY (Prod_Num), ¥
CHECK (Units in (PUNIT('m'), PUNIT('l'), PUNIT('g'), PUNIT('kg'),  ¥
PUNIT(' ')))  )",
        "CREATE TABLE PROD_PARTS ( ¥
Prod_Num     PNUM NOT NULL, ¥
Part_Num     PNUM NOT NULL, ¥
Quantity     DECIMAL(14,7), ¥
PRIMARY KEY (Prod_Num, Part_Num), ¥
FOREIGN KEY (Prod_Num) REFERENCES Product, ¥
FOREIGN KEY (Part_Num) REFERENCES Product, ¥
CHECK (Prod_Num <> Part_Num) )",
        "CREATE TABLE ORD_CUST( ¥
Ord_Num      ONUM NOT NULL, ¥
Cust_Num     CNUM NOT NULL, ¥
Ord_Date     DATE NOT NULL, ¥
PRIMARY KEY (Ord_Num), ¥
FOREIGN KEY (Cust_Num) REFERENCES Customer )",
        "CREATE TABLE ORD_LINE( ¥
Ord_Num      ONUM NOT NULL, ¥
Prod_Num     PNUM NOT NULL, ¥
Quantity     DECIMAL(14,7), ¥
PRIMARY KEY (Ord_Num, Prod_Num), ¥
FOREIGN KEY (Prod_Num) REFERENCES Product, ¥
FOREIGN KEY (Ord_Num) REFERENCES Ord_Cust )"
    };
/* ... */
    num_stmts = sizeof(stmt) / MAX_STMT_LEN;
    printf(">Executing stmts);
    /* Execute Direct statements */
    for (i = 0; i < num_stmts; i++) {
        rc = SQLExecDirect(hstmt, stmt[i], SQL_NTS);
    }
/* ... */