SET SCHEMA 文

SET SCHEMA 文 SET SCHEMA statementSchemaschanging default for session

SET SCHEMA 文により、接続の既定スキーマを指定したスキーマに設定できます。接続から発行される文にて対象のスキーマ名を明示的に指定しなかった場合、既定スキーマが対象のスキーマとなります。

SET SCHEMA文を成功裏に実行するためには、設定するスキーマが存在していなければなりません。スキーマが存在していなければ、エラーとなります。を参照してください。

SET SCHEMA 文はトランザクション処理されません。それゆえSET SCHEMA 文が実行されると、トランザクションがロールバックされても、SET SCHEMA 文により変更されたスキーマのままです。

構文 SET [CURRENT] SCHEMA [=] { スキーマ名 | USER | ? | '<文字列定数>' } | SET CURRENT SQLID [=] { スキーマ名 | USER | ? | '<文字列定数>' }

スキーマ名は最大で128文字からなる識別子です。スキーマ名は二重引用符で囲まれない限り、大文字小文字を区別しません。(例を挙げると、SYSはsYs、SYs、sysのいずれとも等価です。)

USERは現在のユーザです。現在のユーザが定義されていない場合、現在のスキーマは既定でAPPです。(接続にユーザ名が定義されている場合、そのユーザ名に対応したスキーマがあるなら、それが接続の既定のスキーマとなります。

? は準備された文で利用できる動的な引数です。SET SCHEMA文を準備して、異なるスキーマを値にとって実行することができます。このときスキーマの値は文字列定数と扱われ、大文字小文字が区別されます。例えば、APPを指定するには、"app"ではなく"APP"を使います。

-- 以下の例は全て等価で、 -- HOTELというスキーマがあれば動作します。 SET SCHEMA HOTEL SET SCHEMA hotel SET CURRENT SCHEMA hotel SET CURRENT SQLID hotel SET SCHEMA = hotel SET CURRENT SCHEMA = hotel SET CURRENT SQLID = hotel SET SCHEMA "HOTEL" -- クォートされた識別子 SET SCHEMA 'HOTEL' -- クォートされた文字列 --小文字のhotelは存在しないので、 --この例はエラーとなります。 SET SCHEMA = 'hotel' --SQLIDはCURRENTとともに使わなければならないので、 --この例は失敗します。 SET SQLID hotel -- これによりスキーマは現在のユーザIDに設定されます。 SET CURRENT SCHEMA USER // Javaのプログラムでset schemaを使う例です。 PreparedStatement ps = conn.PrepareStatement("set schema ?"); ps.setString(1,"HOTEL"); ps.executeUpdate(); ... do some work ps.setString(1,"APP"); ps.executeUpdate(); ps.setString(1,"app"); //error - string is case sensitive // no app will be found ps.setNull(1, Types.VARCHAR); //error - null is not allowed