クラスへの SQL トリガと外部キーの追加

SQL エイリアス

クラスや大部分のクラス・メンバに、SQL での使用に対して異なる名前を与えることができます。これは、以下のような理由により便利です。

• SQL には、識別子として使用できない多数の予約語があるため。

• InterSystems IRIS では、クラス名やクラス・メンバ名に下線文字がサポートされていないため。

クラスに対する SQL テーブル名を指定するには、クラス・インスペクタでクラス情報を表示し、SqlTableName キーワードの値を編集します。

クラス・メンバに対する SQL 名を指定するには、クラス・インスペクタで希望のプロパティを選択し、対応する SQL 名キーワードの値を編集します (プロパティには SqlFieldName、インデックスには SqlName など)。

SQL ストアド・プロシージャ

SQL ストアド・プロシージャは、InterSystems IRIS メソッドやクラス・クエリで、ストアド・プロシージャとして ODBC や JDBC クライアントによって呼び出すことができます。

InterSystems IRIS は、2 つのスタイルの SQL ストアド・プロシージャをサポートしています。

• クラス・クエリに基づくプロシージャ。

• クラス・メソッドに基づいて結果セットを返さないプロシージャ。

クエリ・ベースのストアド・プロシージャ

結果セットを返す SQL ストアド・プロシージャを作成するには、クラス定義にクエリ定義を追加し、クエリの SqlProc キーワードを True に設定します。以下の操作を行います。

1. [クラス]→[追加]→[クエリ] を選択して新規クエリ・ウィザードを開きます。

2. このウィザードを完了して、新規クエリをクラス定義に追加します。

3. クラス・インスペクタを使用して、クエリ定義キーワード SqlProc の値を True に設定します。

この結果は、以下のようになります。

Class Employee Extends %Persistent 
{

/// A class query listing employees by name.
Query ListEmployees() As %SQLQuery(CONTAINID = "1") [SqlProc]
{
    SELECT ID,Name
    FROM Employee
    ORDER BY Name
}
}

CALL 文を使用して、このストアド・プロシージャを ODBC、または JDBC クライアントから呼び出すことができます。

CALL Employee_ListEmployees()

この呼び出しの後、ODBC アプリケーション、または JDBC アプリケーションは、クラス・クエリから返された結果セットのコンテンツをフェッチできます。

この方法は、カスタム記述コードを基にしたクエリ定義でも使用できます。SQL 文のみを基にしたストアド・プロシージャの定義に限定されません。

メソッド・ベースのストアド・プロシージャの作成

結果セットを返さない SQL ストアド・プロシージャを作成するには、クラス定義にクエリ・メソッドを追加し、メソッドの SqlProc キーワードを True に設定します。以下の操作を行います。

1. 新規メソッド・ウィザードを使用して、クラス定義内にクラス・メソッドを作成します。

2. クラス・インスペクタを使用して、メソッドのキーワード SqlProc の値を True に設定します。

この結果は、以下のようになります。

Class Employee Extends %Persistent
{

  ClassMethod Authenticate(
        ctx As %SQLProcContext,
        name As %String,
        ByRef approval As %Integer
        ) [SqlProc]
  {
    // ...
    Quit
  }

}

SQL ストアド・プロシージャとして使用されたメソッドの最初の引数は、%SQLProcContextOpens in a new tab オブジェクトのインスタンスであることに注意してください。詳細は、"ストアド・プロシージャの定義と使用" を参照してください。

CALL 文を使用して、このストアド・プロシージャを ODBC クライアントから呼び出すことができます。

CALL Employee_Authenticate('Elvis')

このストアド・プロシージャを JDBC クライアントから呼び出すには、以下のコードを使用します。

prepareCall("{? = call Employee_Authenticate(?)}")

クラスへの SQL トリガの追加

SQL トリガは、特定のイベントに応答して、SQL エンジンによって起動されるコードです。

SQL トリガは、オブジェクトの永続性が保持されている間は起動されません (%Storage.SQL ストレージ・クラスを使用していない場合)。

SQL トリガをクラス定義に追加するには、以下の 2 つの方法があります。

• クラス・エディタを使用して、クラス定義の値を編集する方法

• 新規 SQL トリガ・ウィザードを使用する方法

クラス・エディタを使用して SQL トリガを追加するには、クラス・エディタの空の行にカーソルを置き、次のようにトリガ宣言を入力します。

Class MyApp.Company Extends %Persistent 
{

/// This trigger updates the Log table for every insert
Trigger LogEvent [ Event = INSERT ]
{
    // ...
}

}

クラスへの新規 SQL 外部キーの追加

SQL 外部キーは、テーブル内の 1 つまたは複数のフィールドと、他のテーブルのキー (一意のインデックス) 間の整合性制約を定義します。

一般的に、オブジェクト・アプリケーションでは外部キーを使用しません。その代わり、オブジェクト・ベースでの操作に優れたリレーションシップを使用します。リレーションシップは、手動で定義する外部キー定義と同等の整合性制約を (SQL とオブジェクト・アクセスの両方に) 自動的に適用します。

アプリケーションでは、通常、本質的にリレーショナルなアプリケーションの外部キー定義を使用します。

SQL 外部キーをクラス定義に追加するには、以下の 2 つの方法があります。

• クラス・エディタを使用して、クラス定義の値を編集する方法

• 新規 SQL 外部キー・ウィザードを使用する方法

クラス・エディタを使用して SQL 外部キーを追加するには、クラス・エディタの空の行にカーソルを置き、次のように外部キー宣言を入力します。

Class MyApp.Company Extends %Persistent 
{

Property State As %String;

ForeignKey StateFKey(State) References StateTable(StateKey);

}