SET CURRENT DEFAULT TRANSFORM GROUP ステートメント

SET CURRENT DEFAULT TRANSFORM GROUP ステートメントは、 CURRENT DEFAULT TRANSFORM GROUP 特殊レジスターの値を変更します。

このステートメントは、トランザクションの制御下にありません。

呼び出し

このステートメントは、アプリケーション・プログラムに組み込んだり、動的 SQL ステートメントを使用して発行したりすることができます。 このステートメントは、動的に作成できる実行可能ステートメントです。

許可

必要ありません。

構文

Read syntax diagramSkip visual syntax diagramSETCURRENTDEFAULT TRANSFORM GROUP  =  group-name

説明

group-name
トランスフォーム・グループを識別する名前を 1 部構成の名前で指定します。このグループ名はすべての構造化タイプに定義されます。 ここで指定された名前は、このステートメントに続く他のステートメントでも (つまり、 別の SET CURRENT DEFAULT TRANSFORM GROUP ステートメントによって特殊レジスターの値が再び変更されるまで) 参照することができます。

この名前は SQL ID でなければなりません (通常の ID または区切り ID)。 特殊レジスターが設定される際に、 構造化タイプに定義されている group-name の妥当性が検査されることはありません。 特定の構造化タイプを指定して参照するときにのみ、 指定されたトランスフォーム・グループの定義が妥当であるかどうかが検査されます。

ルール

  • 指定された値が group-name の規則に準拠していない場合は、 エラーが発生します (SQLSTATE 42815)。
  • トランスフォーム・グループ group-name に定義されている TO SQL 関数と FROM SQL 関数は、 ユーザー定義構造化タイプのデータをホスト・プログラムとの間で交換するために使用されます。

使用上の注意

  • CURRENT DEFAULT TRANSFORM GROUP 特殊レジスターの初期値は空ストリングです。

例

デフォルトのトランスフォーム・グループを MYSTRUCT1 に設定します。 トランスフォーム・グループ MYSTRUCT1 に定義されている TO SQL 関数と FROM SQL 関数は、 ユーザー定義構造化タイプの変数を現在のホスト・プログラムとの間で交換するために使用されます。
   SET CURRENT DEFAULT TRANSFORM GROUP = MYSTRUCT1