CREATE QUERY

queryname	作成するクエリの名前。識別子です。このクエリ名には、修飾なし (StoreName) と修飾付き (Patient.StoreName) のどちらでも使用できます。パラメータが指定されない場合でも、queryname の後には括弧を続ける必要があります。
parameter_list	オプション — クエリに渡すパラメータのリスト。パラメータのリストは括弧で囲み、パラメータはコンマで区切ります。パラメータを指定しない場合でも、括弧は必須です。
characteristics	オプション — クエリの特性を指定する 1 つ以上のキーワード。使用可能なキーワードは、RESULTS、CONTAINID、FOR、FINAL、ROCEDURE、SELECTMODE です。複数の特性は、空白で区切り、任意の順序で指定できます。
language	オプション — code_body に使用するプログラミング言語を指定するキーワード節。LANGUAGE OBJECTSCRIPT (Caché ObjectScript の場合) または LANGUAGE SQL を指定します。language 節を省略する場合は、SQL が既定です。
code_body	クエリのプログラム・コード SQL プログラム・コードの開始には BEGIN キーワードを使用し、終了には END キーワードを使用します。クエリの code_body は、1 つの完結した SQL 文 (1 つの SELECT 文) のみで構成します。SELECT 文は、セミコロン (;) で終わります。 Caché ObjectScript プログラム・コードは中括弧で囲みます。

CREATE QUERY で作成されるクエリは、ストアド・プロシージャとして公開される場合とそうでない場合があります。ストアド・プロシージャとして公開するクエリを生成するには、characteristics の 1 つとして PROCEDURE キーワードを指定する必要があります。CREATE PROCEDURE 文を使用して、ストアド・プロシージャとして公開されるクエリを生成することも可能です。

クエリをストアド・プロシージャとして公開すると (characteristics に PROCEDURE キーワードを指定)、プロシージャ・コンテキスト・ハンドラを使用によって、プロシージャとその呼び出し元 (ODBC サーバなど) 間でプロシージャ・コンテキストの相互受け渡しが行われます。このプロシージャ・コンテキスト・ハンドラは、Caché によって (%qHandle:%SQLProcContext として) %sqlcontext オブジェクトを使用して自動生成されます。

characteristics キーワード	概要
CONTAINID integer	フィールドが存在する場合は、どのフィールドが ID を返すかを指定します。CONTAINID を ID を返す列の番号に設定するか、または ID を返す列が存在しない場合は 0 を設定します。Caché では、指定されたフィールドが実際に ID を含んでいるかどうかの検証が行われないため、ユーザの入力の誤りによってデータの不一致が起こる可能性があります。
FOR classname	メソッドを生成するクラス名を指定します。そのクラスが存在しない場合は新規作成します。メソッド名を認証することによりクラス名を指定することもできます。FOR 節で指定されたクラス名の方が、メソッド名の修飾により指定されたクラス名よりも優先されます。
FINAL	サブクラスがメソッドをオーバーライドできないように指定します。既定では、メソッドは最終ではありません。FINAL キーワードはサブクラスによって継承されます。
PROCEDURE	クエリが SQL ストアド・プロシージャであることを指定します。ストアド・プロシージャはサブクラスに継承されます(このキーワードは、PROC と略すことができます)。
RESULTS result_set	データ・フィールドをクエリで返された順序で指定します。各フィールドには、列名、データ型 (既定で属性に割り当てられた型と異なる場合)、そしてオプションで見出しを指定します。これらフィールドの特性はコロンで区切ります。result_set 内の異なるフィールドは、コンマで区切ります。 LANGUAGE SQL の場合、クエリが SELECT * でない限り RESULTS キーワードを省略できます。RESULTS キーワードを省略する場合、ROWSPEC がクラス・コンパイル中に自動生成されます。
SELECTMODE mode	クエリをコンパイルするために使用するモードを指定します。可能な値は、LOGICAL、ODBC、RUNTIME、DISPLAY です。既定は RUNTIME です。

SELECTMODE 節は、データを返すモードを指定します。mode 値が LOGICAL の場合は、論理 (内部保存) 値が返されます。例えば、日付は $HOROLOG 形式で返されます。mode 値が ODBC の場合、論理から ODBC への変換が適用され、ODBC 形式値が返されます。mode 値が DISPLAY の場合、論理から表示への変換が適用され、表示形式値が返されます。mode 値が RUNTIME の場合、ローカル変数 %Runtime を設定して、実行時にモードを LOGICAL、ODBC、DISPLAY のいずれかに設定できます。これは、%Library.ResultSet RuntimeMode プロパティを使用して設定できます。RUNTIME モードの既定は LOGICAL です。

  WRITE !,"Creating a query"
  &sql(CREATE QUERY PersonState() BEGIN
       SELECT Name,Home_State FROM Sample.Person ;
       END)
  IF SQLCODE=0 { WRITE !,"Created a query" }
  ELSEIF SQLCODE=-361 { WRITE !,"Query already exists" }
  ELSE { WRITE !,"SQL error: ",SQLCODE }