ISQL の使用法

識別子の競合

InterSystems IRIS には、ISQL 識別子 (テーブル名や列名など) と InterSystems IRIS SQL 予約語との間の競合を解決するための方法として 2 つの選択肢が用意されています。

予約語の接頭語が構成されている場合、InterSystems SQL 予約語と競合する識別子名には、指定されている接頭語が自動的に割り当てられます。この接頭語付けは、SQL 予約語リストに競合するあらゆる識別子に対して実行されます。このリストには、(ISQL 識別子の解決を目的として) 予約語を追加でき、それにはグローバル変数 ^%SYS("xsql","informix",word) を使用します。ここで、word には、予約する語を大文字で指定します。予約語リストに追加できるこの機能は、異なる予約語リストを使用するデータベース・システム間の整合性の維持に役立ちます。

予約語の接頭語は構成されておらず、区切り識別子のサポートが構成されている場合、コンバータは SQL 予約語リスト (および追加の予約語) に競合する識別子を引用符で囲むことによって区切ります。区切り識別子は、予約語を含め、あらゆる値を取ることができます。

TRACE

XSQL DEFERRED 構文は、実行時に動的に作成されます。結果の実装は、後続の実行のパフォーマンス向上のためにキャッシュされます。キャッシュされた実装は、いずれかの参照オブジェクトが変更されるたびに削除されます。Informix ISQL コンバータでは、DEFERRED 構文テキスト、引数値、および発生エラーを記録するコンパイル済みプロシージャ向けに TRACE 機能がサポートされます。

従来の関数呼び出しモード

[ストアドプロシージャ呼び出しの結果を Resultset で返す] 構成設定は、複数の値を返す関数がそれらの値をどのように返すのかを制御します。既定の “[はい]” では、値が結果セットとして返されます。この設定では、ISQL の従来の関数呼び出しモードがサポートされるため、いずれの返り値も、1 つの返り値と出力パラメータのいずれかまたは両方ではなく、単一行の結果セットとして返されます。

一時テーブル

Informix 一時テーブル (CREATE TEMP TABLE) は、InterSystems IRIS グローバル・プライベート一時テーブルとして実装されます。これらの一時テーブルは、現在のプロセスからのみアクセスでき、明示的に削除されるかプロセスが終了するまで定義されます。これらの一時テーブルは、InterSystems SQL コマンド CREATE GLOBAL PRIVATE TEMPORARY TABLE を使用して作成されます。

GLOBAL PRIVATE TEMPORARY テーブルは、テーブル・オブジェクトが %sqlcontext ではなく %processcontext で保持される点を除いて、GLOBAL TEMPORARY テーブルと同じです。%processcontext は、プロセスの存続中は新しく開始されることも強制終了されることもない ProcedureContext インスタンスです。このため、%processcontext によって参照される一時テーブル・オブジェクトは、削除されるかプロセスが終了するまでスコープ内にあります。一時テーブルを削除しても、そのテーブルが物理的には削除されない場合があります。アクティブな結果セットがその一時テーブルを参照する場合、その一時テーブルは、それらの結果セットのオブジェクトがクローズ (破棄) されるまでアクティブなままです。アクティブな結果セットに起因してアクティブなままである一時テーブルを作成しようとすると、エラーが生じます。

プロシージャの呼び出しと反復子関数

Informix では以下の 4 つのタイプの SPL ルーチンがサポートされます。

• 何の値も返さないプロシージャ (SPL)。DO コマンドを使用して InterSystems IRIS から呼び出されます。

• 単一値を返す標準関数 (SPL RETURN)。SET retval=function() を使用して InterSystems IRIS から呼び出されます。

• 複数の値を返す関数 (SPL RETURN value1[,value2[,...]])。Informix SPL ルーチンでは、出力形式引数はサポートされていません。InterSystems IRIS では、これは複数の出力仮引数を取るクラス・メソッドに変換されます。この関数は、DO コマンドを使用して呼び出されます。出力値はプロシージャ・コンテキスト・オブジェクトから取得され、宣言された INTO 変数に割り当てられます。

• それぞれに 1 つ以上の値が含まれる行を複数返す反復子関数 (SPL RETURN...WITH RESUME)。InterSystems IRIS では、複数の出力仮引数があり返り値のないクラス・メソッドとしてこの機能は実装されます。この関数は、DO コマンドを使用して呼び出されます。この関数は、結果セット・クラスを使用して、まず結果セットに連続する行を挿入してから、反復子を結果セットの最初の行にリセットして複数行を取得できるようにします。行は、プロシージャ・コンテキスト・オブジェクトで返される最初の結果セットから取得されます。結果セット内の列は、宣言された返りタイプに対応します。

返り変数に定義されているサイズより返り値が長い場合、InterSystems IRIS は (Informix と同様に) 返り値を自動的に切り捨てます。

スカラ関数は結果セットを返すことができません。InterSystems IRIS では、単一の返り値が必要だが実際には複数行を返す関数が呼び出されると、SQLCODE -432 を発行します。これは、Informix エラー -686 に相当します。

反復子関数では、フローに 1 つの大きな違いがあります。Informix の文 FOREACH EXECUTE は、結果セットを返すプロシージャを呼び出します。この結果セットは、呼び出されたプロシージャ・コンテキストのスコープ内でのみ有効な一時オブジェクトを参照できます。元の Informix では、FOREACH EXECUTE は、その前の RETURN WITH RESUME 文の時点で実行を再開します。変換された ObjectScript メソッドは、反復子関数を実行して完了させ、FOREACH ループによって反復されることになる結果セットで結果を返します。実際の列値は、呼び出されたプロシージャ・コンテキストなしで、結果セットから直接取得されます。EXIT FOREACH は、カーソルをクローズして、最後に取得された行のロックを解除します。

仮引数

InterSystems IRIS では、仮引数に対して、DEFAULTFORMAL および DEFAULTFORMALTYPE の 2 つの設定がサポートされています。DEFAULTFORMAL は、ダミー仮引数の名前を指定するオプション設定です。DEFAULTFORMALTYPE は、DEFAULTFORMAL 引数のタイプを指定するオプション設定です。

DEFAULTFORMAL を設定すると、その名前を持つ仮引数が、いずれの仮引数も宣言しないプロシージャまたは関数に対して生成されます。DEFAULTFORMALTYPE を定義した場合、これは生成された仮引数に使用される Informix タイプの宣言になります。DEFAULTFORMALTYPE を定義しない場合、既定の INTEGER に設定されます。

Informix ROWID

プロシージャ変換ユーティリティは、ROWID の ISQL 列参照を %ID に変換します。Informix では、ROWID 列は、WITH ROWIDS 節を使用して作成された断片化されているテーブルや断片化されていないテーブルの非表示列です。ROWID 列は行ごとに固有ですが、必ずしも連続する必要はありません。InterSystems SQL では、ROWID 列は %ID に相当します。

NULL および空文字列の処理

Informix では、文字列データ型 CHAR および VARCHAR では、空文字列 ("") は単一の空白 (" ") とまったく同じように処理されます。数値、時刻、および日付のデータ型すべてにおいて、空文字列 ("") は NULL として処理されます。

文字列を連結する場合、NULL を string に連結すると、NULL になります。空文字列を string に連結しても、string には何も影響がありません。

末尾の空白文字列

ObjectScript で末尾の空白文字列は自動的に切り捨てられます。これは、CHAR と VARCHAR の両方のデータ型に当てはまります。これは、Informix の標準の動作とは異なるため、データの移行時に重要な考慮事項となる可能性があります。

DATETIME データ型

InterSystems IRIS では、Informix DATETIME データ型を %Library.InformixTimestamp データ型クラスにマップすることにより、このデータ型をサポートしています。Informix には、完全な日付や時刻は必要ありません。Informix では、修飾子を使用して、日付と時刻のコンポーネントの範囲が指定されます。InterSystems IRIS では、最大および最小の修飾子を指定するための構文がサポートされます。YEAR TO DAY 修飾子は、DATE データ型としてマップされます。MINUTE TO SECOND 修飾子は、TIME データ型としてマップされます。その他すべての修飾子は %Library.InformixTimeStamp としてマップされます。例えば、YEAR TO SECOND および HOUR TO SECOND などがあります。

InterSystems IRIS では、DATETIME 算術がサポートされます。InterSystems IRIS では、DATE、TIME、TIMESTAMP、および INTERVAL に対して加算と減算の演算がサポートされます。

SERIAL データ型

InterSystems IRIS では、Informix SERIAL データ型を %Library.Counter データ型にマップすることにより、これをサポートしています。特定のフィールドがデータ型 %Counter として定義されている場合、InterSystems IRIS では SQL INSERT の実行時に、そのフィールドに値が挿入されない、0 (ゼロ) が挿入される、または数値以外の値が挿入されるときに、カウンタ値が 1 ずつ増加され、結果のカウンタ値がこのフィールドに割り当てられます。正の整数値をこのフィールドに明示的に挿入する場合は、その値を挿入します。また、必要に応じて、カウンタ・ノードの値が指定フィールド値を下回らないように、カウンタ・ノードの値を進めます。

%Counter 型で定義されているフィールドに UNIQUE 制約が自動的に作成されることはありません。値が必ず UNIQUE になるようにする場合は、そのプロパティに独自の UNIQUE インデックスを作成する必要があります。

%Counter フィールドとして定義されているフィールドは、そのフィールドの古い値が 0 または NULL でない限り更新されない場合があります。データが含まれる既存テーブルに %Counter フィールドを追加してから戻り、既存の行で %Counter フィールドにデータを入力する場合、これが当てはまる場合があります。このとき、%Counter フィールドを更新しようとすると、SQLCODE -105 エラーと %msg テキストが生成されます。

InterSystems SQL %Counter データ型には、Informix SERIAL データ型と同様の機能が用意されています。Informix では、テーブルごとに 1 つの SERIAL フィールドという制限がありますが、InterSystems IRIS には、テーブルごとに定義する %Counter フィールドの数に制限はありません。

ISQL のコメントと注釈

ISQL では、以下のコメント・タイプがサポートされています。

• –– comment (2 つのハイフン) 単一行コメントの接頭語。

• { comment } 複数行のコメント。

• /* comment */ 複数行のコメント。

複数行のコメントを入れ子にすることができます。

ISQL では、以下の単一行の注釈形式がサポートされています。

• ––!! annotation

• --## annotation

SELECT 文に埋め込まれている注釈は、InterSystems SQL への変換後に FROM 節に追加されます。以下はその例です。

FOREACH
    SELECT a,b,c 
    INTO v_a, v_b, v_c 
    FROM
       --!!%NOFLATTEN %NOTOPOPT 
       my_table as f 
    WHERE f.a IN ( "a") AND f.b = 88 AND f.c ="ZZ" 
    ORDER BY a, c DESC, b DESC

注釈は、SELECT 文内でのみ使用できます。

MATCHES 演算子

ISQL では、パターン・マッチング用に MATCHES 演算子がサポートされています。この演算子では、0 以上の文字を表すために使用できる * ワイルドカード文字がサポートされています。

DEFINE var LIKE コマンド

DEFINE var LIKE column 文では、特定の列のデータ型に基づいて、特定のローカル変数のデータ型が定義されます。このコマンドは、変換時に列参照を解決できる場合に使用できます。

LET コマンド

LET コマンドは、変数に値を割り当てるために使用します。以下のように、複数の変数への割り当てに使用できます。

LET a,b = c,d;

サポートしている関数

Informix コンパイラでは、以下の Informix 関数がサポートされます。

• DATE

• CURRENT は内部ストレージ形式 ($HOROLOG 値の日付部分) で現在の日付を返します。

• LOWER

• REPLACE

• SUBSTR

• SUBSTRING

• TRIM (部分的にサポート)

• UPPER