| Oracle Rdb SQLリファレンス・マニュアル リリース7.2 E06178-01 |
|
 戻る |
 次へ |
SQL> CREATE DOMAIN TIME_DOM IS TIME ( 2 ) DEFAULT '00:00:00.00' ; %SQL-F-DEFVALINC, You specified a default value for TIME_DOM which is inconsistent with its data type SQL> CREATE DOMAIN TIME_DOM IS TIME ( 2 ) DEFAULT TIME '00:00:00.00' ; |
SQL> -- The CHECK constraint can reference the VALUE keyword. SQL> -- SQL> ALTER DOMAIN D1 INTEGER cont> ADD CHECK (VALUE > 10) cont> NOT DEFERRABLE; SQL> SHOW DOMAIN D1; D1 INTEGER Valid If: (VALUE > 10) SQL> ROLLBACK; SQL> -- SQL> -- The CHECK constraint can reference the domain name. SQL> -- SQL> ALTER DOMAIN D1 INTEGER cont> ADD CHECK (D1 > 10) cont> NOT DEFERRABLE; SQL> SHOW DOMAIN D1 D1 INTEGER Valid If: (D1 > 10) |
例1: ドメインPOSTAL_CODE_DOMの変更この例では、ドメインPOSTAL_CODE_DOMを変更し、より長い郵便番号を受け入れるようにします。
SQL> -- SQL> -- The data type of the current domain POSTAL_CODE_DOM is CHAR(5): SQL> -- SQL> SHOW DOMAIN POSTAL_CODE_DOM POSTAL_CODE_DOM CHAR(5) Comment: standard definition of ZIP Rdb default: SQL> -- SQL> -- Now, alter the domain to accommodate larger postal codes: SQL> -- SQL> ALTER DOMAIN POSTAL_CODE_DOM IS CHAR(10); SQL> -- SQL> -- The SHOW TABLES statement shows how changing the SQL> -- domain POSTAL_CODE_DOM changes all the SQL> -- columns that were created using the domain: SQL> -- SQL> SHOW TABLE COLLEGES Information for table COLLEGES Comment on table COLLEGES: names and addresses of colleges attended by employees Columns for table COLLEGES: Column Name Data Type Domain ----------- --------- ------ . . . POSTAL_CODE CHAR(10) POSTAL_CODE_DOM . . . SQL> SHOW TABLE EMPLOYEES Information for table EMPLOYEES Comment on table EMPLOYEES: personal information about each employee Columns for table EMPLOYEES: Column Name Data Type Domain ----------- --------- ------ . . . POSTAL_CODE CHAR(10) POSTAL_CODE_DOM
例2: ドメインID_DOMの変更
次の例では、従業員識別子フィールドの標準として定義されているドメインID_DOMのデータ型を変更します。
例1では、ドメインPOSTAL_CODE_DOMに基づく索引は存在しませんでした。この例では、列を参照する複数の索引がID_DOMに基づいて作成されています。次の例に示すように、ドメインを変更する前に索引を削除する必要があります。
SQL> -- The data type for the domain ID_DOM is CHAR(5): SQL> -- SQL> SHOW DOMAIN ID_DOM ID_DOM CHAR(5) Comment: standard definition of employee id SQL> -- SQL> -- The first attempt to alter the domain ID_DOM fails. SQL> -- You must first delete all constraints that use the SQL> -- field EMPLOYEE_ID. SQL> -- SQL> ALTER DOMAIN ID_DOM CHAR(6); %RDB-E-NO_META_UPDATE, metadata update failed -RDMS-F-FLDINCON, field EMPLOYEE_ID is referenced in constraint RESUMES_FOREIGN1 -RDMS-F-FLDNOTCHG, field EMPLOYEE_ID has not been changed SQL> ALTER TABLE RESUMES DROP CONSTRAINT RESUMES_FOREIGN1; SQL> -- SQL> ALTER DOMAIN ID_DOM IS CHAR(6); %RDB-E-NO_META_UPDATE, metadata update failed -RDMS-F-FLDINCON, field EMPLOYEE_ID is referenced in constraint DEGREES_FOREIGN1 -RDMS-F-FLDNOTCHG, field EMPLOYEE_ID has not been changed SQL> -- SQL> ALTER TABLE DEGREES DROP CONSTRAINT DEGREES_FOREIGN1; . . . SQL> -- You must then delete all indexes. SQL> -- SQL> ALTER DOMAIN ID_DOM IS CHAR(6); %RDB-E-NO_META_UPDATE, metadata update failed -RDMS-F-FLDINUSE, field EMPLOYEE_ID is referenced in index EMP_EMPLOYEE_ID -RDMS-F-FLDNOTCHG, field EMPLOYEE_ID has not been changed SQL> -- SQL> DROP INDEX EMP_EMPLOYEE_ID; SQL> -- SQL> ALTER DOMAIN ID_DOM IS CHAR(6); %RDB-E-NO_META_UPDATE, metadata update failed -RDMS-F-FLDINUSE, field EMPLOYEE_ID is referenced in index JH_EMPLOYEE_ID -RDMS-F-FLDNOTCHG, field EMPLOYEE_ID has not been changed SQL> -- SQL> DROP INDEX JH_EMPLOYEE_ID; SQL> -- . . . SQL> -- SQL> -- You can now alter the domain. SQL> -- SQL> ALTER DOMAIN ID_DOM IS CHAR(6); SQL> SHOW DOMAIN ID_DOM; ID_DOM CHAR(6) Comment: standard definition of employee id
例3: ALTER DOMAIN文によるデフォルト値の指定
次の例では、ドメインが変更され、それらのドメインに対してデフォルト値が指定されています。
SQL> -- If no date is entered, use the NULL default. SQL> -- SQL> ALTER DOMAIN DATE_DOM cont> SET DEFAULT NULL; SQL> -- SQL> -- If the street address takes only one line, SQL> -- use "NONE" for the default for the second line. SQL> -- SQL> ALTER DOMAIN ADDRESS_DATA_2_DOM cont> SET DEFAULT 'NONE'; SQL> -- SQL> -- If most employees work full-time, make the code SQL> -- for full-time, 1, the default work status. SQL> -- SQL> ALTER DOMAIN STATUS_CODE_DOM cont> SET DEFAULT '1';
例4: ALTER DOMAIN文による編集文字列の指定
次の例では、ドメインMIDDLE_INITIAL_DOMに基づく列をSQLでどのように表示するかを制御するEDIT STRING句を指定します。この例の編集文字列X.?'No middle initial'では、ドメインに基づく列が、後にピリオドの付いた1文字として表示されるように指定します。この列に対する値が存在しない場合、SQLにより疑問符の後に文字列'No middle initial'が続いて表示されます。
SQL> ALTER DOMAIN MIDDLE_INITIAL_DOM cont> EDIT STRING 'X.?''No middle initial'; SQL> SELECT MIDDLE_INITIAL FROM EMPLOYEES; MIDDLE_INITIAL A. D. No middle initial No middle initial . . .
例5: ALTER DOMAIN文による新規照合順番の指定
次の例では、事前定義されたNCS照合順番FRENCHを指定したドメインが作成されます。最初に、CREATE COLLATING SEQUENCE文を実行する必要があります。この例では、次に照合順番がフィンランド語に変更され、その後はドメインが照合順番を持たないように指定されます。
SQL> CREATE COLLATING SEQUENCE FRENCH FRENCH; SQL> CREATE DOMAIN LAST_NAME_ALTER_TEST CHAR (10)- cont> COLLATING SEQUENCE IS FRENCH; SQL> -- SQL> SHOW DOMAIN LAST_NAME_ALTER_TEST LAST_NAME_ALTER_TEST CHAR(10) Collating sequence: FRENCH SQL> -- SQL> -- Now, change the collating sequence to Finnish. You must first SQL> -- execute the CREATE COLLATING SEQUENCE statement. SQL> -- SQL> CREATE COLLATING SEQUENCE FINNISH FINNISH; SQL> ALTER DOMAIN LAST_NAME_ALTER_TEST CHAR (10)- cont> COLLATING SEQUENCE IS FINNISH; SQL> -- SQL> SHOW DOMAIN LAST_NAME_ALTER_TEST LAST_NAME_ALTER_TEST CHAR(10) Collating sequence: FINNISH SQL> -- SQL> -- Now, alter the domain so there is no collating sequence. SQL> -- SQL> ALTER DOMAIN LAST_NAME_ALTER_TEST CHAR (10)- cont> NO COLLATING SEQUENCE; SQL> SQL> SHOW DOMAIN LAST_NAME_ALTER_TEST LAST_NAME_ALTER_TEST CHAR(10)
例6および7については、次を前提とします。
- データベースは、データベースのデフォルト・キャラクタ・セットをDEC_KANJI、各国語キャラクタ・セットをKANJIと指定して作成されています。
- ドメインDEC_KANJI_DOMは、データベースのデフォルト・キャラクタ・セットを指定して作成されています。
- 表COLOURSは、DEC_KANJI_DOMドメインを列ROMAJIに割り当てて作成されています。
例6: ドメインDEC_KANJI_DOMの変更
SQL> SET CHARACTER LENGTH 'CHARACTERS'; SQL> SHOW DOMAIN DEC_KANJI_DOM; DEC_KANJI_DOM CHAR(8) SQL> ALTER DOMAIN DEC_KANJI_DOM NCHAR(8); SQL> SHOW DOMAIN DEC_KANJI_DOM; DEC_KANJI_DOM CHAR(8) KANJI 8 Characters, 16 Octets SQL>
例7: データを含む表で使用されるドメインの変更エラー
次の例では、列ROMAJIはドメインDEC_KANJI_DOMに基づきます。ドメインのキャラクタ・セットを変更する前に列ROMAJIにデータが含まれている場合は、ドメイン変更後にデータ検索を試行すると、SQLによって次のエラーが表示されます。
SQL> SELECT ROMAJI FROM COLOURS; %RDB-F-CONVERT_ERROR, invalid or unsupported data conversion -RDMS-E-CSETBADASSIGN, incompatible character sets prohibits the requested assignment SQL> -- SQL> -- To recover, use the ROLLBACK statement or reset the character set to SQL> -- its original value. SQL> -- SQL>ROLLBACK; SQL> SELECT ROMAJI FROM COLOURS; ROMAJI kuro shiro ao aka ki midori 6 rows selected SQL>
例8: ドメイン制約の変更
次の例では、ドメインの既存の制約をどのように変更するかを示します。
SQL> SHOW DOMAIN TEST_DOM TEST_DOM DATE ANSI Rdb default: NULL VALID IF: (VALUE > DATE'1900-01-01' OR VALUE IS NULL) SQL> -- SQL> -- Add the new domain constraint definition. SQL> -- SQL> ALTER DOMAIN TEST_DOM cont> ADD CHECK (VALUE > DATE'1985-01-01') cont> NOT DEFERRABLE;
例9: ストアド・プロシージャ・ドメイン依存性の作成
次のストアド・モジュールのコード部分は、パラメータ・リスト内のドメインおよびストアド・プロシージャ・ブロック内のドメインを示します。
SQL> create module SAMPLE cont> procedure FIRST_NAME cont> (in :id id_dom cont> ,out :first_name char(40)); cont> begin cont> declare :fn first_name_dom; cont> select first_name into :fn cont> from employees cont> where employee_id = :id; cont> -- return capitalized first name cont> set :first_name = cont> UPPER (substring (:fn from 1 for 1)) || cont> LOWER (substring (:fn from 2)); cont> end; cont> end module; SQL> SQL> declare :first_name first_name_dom; SQL> call FIRST_NAME ('00164', :first_name); FIRST_NAME Alvin SQL> SQL> alter domain id_dom cont> char(10); %RDB-E-NO_META_UPDATE, metadata update failed -RDMS-F-RTNEXI, field "ID_DOM" is used in routine "FIRST_NAME" -RDMS-F-FLDNOTCHG, field ID_DOM has not been changed SQL> SQL> alter domain first_name_dom cont> char(60);
- パラメータ・リストで指定されたドメイン
ストアド・ルーチンのパラメータ・リスト（id_number）でドメインを指定し、続いてそのドメインを変更しようとすると、SQLではドメインとドメインが存在するストアド・ルーチン間に依存性が設定されているため、ALTER DOMAIN文は失敗します。文が失敗するため、Oracle Rdbではストアド・ルーチンが無効化されません。Oracle Rdbでは、このドメイン・パラメータ・リスト依存性がRDB$PARAMETERSに保持されます。- ストアド・ルーチン・ブロックで指定されたドメイン
ストアド・ルーチン・ブロック内でドメイン（last_name）を指定し、続いてそのドメインを変更する場合は、ALTER DOMAIN文が正常に実行されます。さらにストアド・ルーチンを呼び出すと、ドメインの新規の定義が使用されます。
例10: デフォルト値を指定するためのドメイン変更
この例では、ドメインに追加されたデフォルト値がそのドメインを使用して表に伝播されることを示します。
SQL> -- Display the current domain definition. SQL> SHOW DOMAIN DEPARTMENT_NAME DEPARTMENT_NAME CHAR(30) Comment: Department name Missing Value: None SQL> -- Alter the domain to provide a default value SQL> -- for DEPARTMENT_NAME. SQL> ALTER DOMAIN DEPARTMENT_NAME cont> SET DEFAULT 'Not Recorded'; SQL> -- Display the altered domain definition. SQL> SHOW DOMAIN DEPARTMENT_NAME; DEPARTMENT_NAME CHAR(30) Comment: Department name Oracle Rdb default: Not Recorded Missing Value: None SQL> -- Insert a record and omit the value for DEPARTMENT_NAME. SQL> INSERT INTO DEPARTMENTS (DEPARTMENT_CODE) cont> VALUES cont> ('GOGO'); 1 row inserted SQL> COMMIT; SQL> -- Select the newly inserted record to show that the SQL> -- default for the DEPARTMENT_NAME domain was inserted. SQL> SELECT * FROM DEPARTMENTS WHERE DEPARTMENT_CODE='GOGO'; DEPARTMENT_CODE DEPARTMENT_NAME MANAGER_ID BUDGET_PROJECTED BUDGET_ACTUAL GOGO Not Recorded NULL NULL NULL 1 row selected
CREATE MODULE文またはCREATE FUNCTION文を使用して作成されたファンクションの属性を変更できます。次のように使用できます。
- 強制的なストアド（SQL）・ファンクションのコンパイル（COMPILEオプション）
- 外部ファンクションの属性変更
- ファンクションのコメント変更
ALTER FUNCTION文は次の環境で使用できます。
- 対話型SQL内
- ホスト言語プログラムに埋め込まれる場合
- SQLモジュールのプロシージャの一部として
- 動的SQLで動的に実行される文として
BIND ON CLIENT SITE
BIND ON SERVER SITE
外部ルーチン実行の実行モデルおよび環境を選択します。CLIENTサイト・バインディングにより、外部ルーチンがアクティブ化され、OpenVMSデータベース・クライアント（アプリケーション）・プロセスで実行されます。これはデフォルトのバインディングです。このバインディングによって最も効率的な実行特性が提供され、I/Oデバイスなどのリソースを共有し、外部ルーチンをクライアント・アプリケーションの一部と同様にデバッグできます。ただし、このバインディングはアドレス空間の制限を受ける場合があります。データベース・バッファと仮想メモリーを共有しているため、このバインディングはクライアント・プロセスのシステム・ユーザー環境に限定されており、高レベルの権限が必要なアプリケーションの実行時に、外部ルーチンを実行することは禁止されています。
SERVERサイト・バインディングにより、外部ルーチンがデータベース・クライアントおよびサーバーとは別のプロセスでアクティブ化されます。このプロセスは、データベース・プロセスと同じノードで開始されます。このバインディングでは、適切な実行特性、より大きいアドレス空間、実際のセッション・ユーザー環境が提供され、高レベルの権限によるクライアント・プロセス制約を受けません。ただし、このバインディングでは、クライアントとI/Oデバイスなどのリソースを共有できないため（特に、クライアント対話型端末への接続がないため）、一般的にルーチンをデバッグできません。
BIND SCOPE CONNECT
BIND SCOPE TRANSACTION
外部ルーチンがアクティブ化される有効範囲と、外部ルーチンが非アクティブ化されるポイントを定義します。デフォルトの有効範囲はCONNECTです。
- CONNECT
データベースからデタッチする（またはデタッチせずに終了する）と、アクティブなルーチンが非アクティブ化されます。- TRANSACTION
トランザクションが中止（COMMITまたはROLLBACK）されると、アクティブなルーチンが非アクティブ化されます。トランザクションを実行していない場合、有効範囲はCONNECTに戻ります。
COMMENT IS string
ファンクションに関するコメントを追加します。SQLでは、SHOW FUNCTIONS文の実行時にコメントのテキストが表示されます。コメントは一重引用符（'）で囲み、コメント内の複数の行はスラッシュ（/）で区切ります。この句は、COMMENT ON FUNCTION文と同義です。
COMPILE
COMPILEオプションにより、Oracle Rdbサーバーで強制的にストアド（SQL）・ファンクションを再コンパイルします。外部ファンクションには反映されません。DROP...CASCADE操作の実行によってファンクションが無効化されている場合は、COMPILEを使用します。このメカニズムは、以前のバージョンで使用可能なSET FLAGS 'VALIDATE_ROUTINE'メソッドより優先されます。
DEFAULT LOCATION
LOCATION 'image-location'
外部ルーチン・イメージのデフォルトの位置または特定の位置です。結果ファイルの仕様には、タイプ.exeが含まれている必要があります。これは、イメージ・ファイルの仕様または単に論理名になります。
SQLでは、次の要素の組合せに基づいてルーチンを選択します。
- Image string
位置はDEFAULT LOCATIONにデフォルトで設定されます。これはファイル仕様文字列RDB$ROUTINESを表します。- Logical name translation
WITH ALL LOGICAL_NAME TRANSLATION句およびWITH SYSTEM LOGICAL_NAME TRANSLATION句によって、ロケーション文字列にある論理名の変換方法を指定します。
変換オプションが指定されていない場合、またはWITH ALL LOGICAL_NAME TRANSLATIONが指定されている場合は、論理名はデフォルトの方法で変換されます。
If WITH SYSTEM LOGICAL_NAME TRANSLATIONが指定されている場合は、ロケーション文字列の論理名は、SYSTEM論理名表のEXECUTIVE_MODE論理名のみを使用して展開されます。
DETERMINISTIC
NOT DETERMINISTIC
これらの句は、SQL/PSM規格への準拠において、VARIANT句およびNOT VARIANT句と同義です。DETERMINISTIC句は、ファンクションに対する入力が同じであれば、出力も同じになることを示します。これはNOT VARIANT句と同義です。
NOT DETERMINISTIC句は、ファンクションの出力は、その入力に依存しないことを示します。これはVARIANT句と同義です。
external-body-clause
ルーチン名、ルーチンの実行可能イメージの位置、ルーチンをコーディングする言語など、ルーチンのキー特性を識別します。external-body-name
外部ルーチン名です。この名前を指定しない場合は、external-routine-name句で指定した名前がSQLに使用されます。この名前により、ルーチン本体の起動ごとにコールされるルーチン・エントリ・アドレスが定義されます。location句で選択された外部ルーチン・イメージには、この名前付きルーチンが必要です。
引用符付きでない名前は、大文字に変換されます。
LANGUAGE language-name
外部ルーチンがコーディングされたホスト言語の名前です。ADA、C、COBOL、FORTRAN、PASCALまたはGENERALを指定できます。GENERALキーワードを使用すると、任意の言語で記述したルーチンをコールできます。言語固有の情報の詳細は、「使用方法」を参照してください。
notify-clause
特定の外部ルーチンまたはデータベース関連のイベントが発生した場合に、2番目に呼び出される（通知される）ルーチンの名前を指定します。この名前により、通知ルーチンの起動ごとにコールされるルーチン・エントリ・アドレスが定義されます。location句で選択された外部ルーチン・イメージには、この名前付きルーチンが必要です。通知ルーチンに関連するイベントはON BIND、ON CONNECTおよびON TRANSACTIONです。複数のイベントを指定できます。
次に、イベントと各イベントの有効範囲について説明します。
BIND ルーチンのアクティブ化からルーチンの非アクティブ化 CONNECT データベース・アタッチからデータベース切断 TRANSACTION 開始トランザクションからコミットまたはロールバック・トランザクション
RENAME TO
変更中のファンクション名を変更します。詳細は、「RENAME文」を参照してください。新規名がシノニム名である場合は、エラーが発生します。RETURNS NULL ON NULL INPUT
CALLED ON NULL INPUT
これらの句では、1つ以上のファンクション引数がNULLの場合に、外部ファンクションの起動方法を制御します。CALLED ON NULL INPUT句では、ファンクションが正常に実行されることを指定します。PARAMETER STYLE GENERAL句が指定された場合の正常実行は、NULL値が検出された場合の、SQLによるランタイム・エラーを返す方法の指定です。RETURNS NULL ON NULL INPUT句により、Oracle Rdbに対してファンクションを回避し、単にNULLを返すよう指示されます。このオプションはSIN、COS、CHECKSUM、SOUNDEXなど、通常、引数がNULLの場合にUNKNOWNを返すライブラリ・ファンクションで有用です。
デフォルトはCALLED ON NULL INPUT句です。
VARIANT
NOT VARIANT
これらの句は、SQL/PSM規格への準拠において、DETERMINISTIC句およびNOT DETERMINISTIC句と同義です。DETERMINISTIC句は、ファンクションに対する入力が同じであれば、出力も同じになることを示します。これはNOT VARIANT句と同義です。NOT DETERMINISTIC句は、ファンクションの出力は、その入力に依存しないことを示します。これはVARIANT句と同義です。
- この文を実行するには、指定したプロシージャに対するALTER権限が必要です。プロシージャがモジュールの一部である場合は、そのモジュールに対するALTER権限が必要です。
- COMPILE句、COMMENT句、VARIANT句、DETERMINISTIC句およびRENAME TO句を除き、ALTER FUNCTION文の属性はすべて、外部ファンクションにのみ適用されます。被参照ファンクションがSQLストアド・ファンクションである場合はエラーが返されます。
- ALTER FUNCTION文によって、名前付きファンクション用のRDB$ROUTINES表のRDB$LAST_ALTERED列がトランザクションのタイムスタンプで更新されます。
- RENAME TO句には、このデータベースに対して有効なシノニムが必要です。「ALTER DATABASE文」のSYNONYMS ARE ENABLED句に関する説明を参照してください。これらのシノニムがデータベース定義またはアプリケーションによって使用されていない場合は、削除される可能性があります。
- ルーチンに多くの依存性がある場合は、DROP...CASCADEコマンド・シーケンスおよびCREATEコマンド・シーケンスよりALTERが優先的に使用されます。ALTERには、このルーチンと任意のトリガー、ストアド・ルーチンまたは他のデータベース・オブジェクトとの間に存在する既存の依存性情報が保持されているためです。
例1: ファンクションのNOT DETERMINISTICへの変更
ファンクションが作成された場合、DETERMINISTICであると仮定します。つまり、入力値が同じであれば、同じ結果が返されることを意味します。次に示すGET_TIMEファンクションなどのパラメータがルーチンにない場合、異なるものは入力できません。この場合、このファンクションは、以前に返された行ごとの結果を使用するのではなく、行の処理ごとにRdbオプティマイザによってファンクションが呼び出されるようにNOT DETERMINISTICとして定義する必要があります。
DROP FUNCTIONおよびCREATE FUNCTIONは同じファンクションを実行できますが、ALTER FUNCTIONではデータベース内に存在する依存性が保持されます。
SQL> alter function GET_TIME cont> not deterministic cont> comment 'Fetch time from clock' cont> / 'Every call must be executed, so change to be' cont> / 'NOT DETERMINISTIC'; SQL> SQL> show function GET_TIME; Information for function GET_TIME Function is Not Deterministic (variant) Function ID is: 262 External Location is: SYS$SHARE:CLOCKSHR.EXE Entry Point is: GET_TIME Comment: Fetch time from clock Every call must be executed, so change to be NOT DETERMINISTIC Language is: COBOL GENERAL parameter passing style used Number of parameters is: 0 Parameter Name Data Type Domain or Type -------------- --------- -------------- TIME(2) Function result datatype Return value is passed by value
