CHAPTER 4: データ定義言語

Syntax

注意

1. VIEWの基本となるテーブルは、いくつかのファイルシステム上の、いくつかの データベースに存在することができます。分散型データにアクセスするためにVIEWを 使用することに関しては、Empress SQL: ユーザーズガイドを参照してください。

2. VIEWはシンプルにも複雑にもなりえます。シンプルなVIEWは単一のテーブルに アクセスして、テーブル中のフィールドのレコードにアクセスをします。複雑な VIEWは、共通のフィールド(複数可)上でリンクしたいくつかのテーブルに同時に アクセスします。この方法でレコードをリンクする操作はjoinと呼ばれます。 連結するSELECTコマンドについては、SELECT コマンドまたは、Empress SQL:ユーザーズ ガイドのクエリー言語トピックスを参照してください。

3. フィールド名はVIEWの中で指定することができます。フィールド名を指定する場合 、括弧でを囲まなくてはなりません。

4. CREATE VIEWコマンドのSELECT部分は関数(MAX、 AVGなど)、GROUP BY句あるいはHAVING句を含んでいる 場合やWHERE句には、演算子あるいはサブクエリーを含む表現を含んでいる 場合もあり、キーワードDISTINCTが使用される場合があります。

5. VIEWはVIEW上で作成することができます(ネストされたVIEW)。すなわち、コマンド のSELECT部分のテーブルはVIEWでもかまいません。一般に、テーブルが検索 のために指定される場合は、VIEWが使用されても問題ありません。VIEWのデータへの アクセスは、基本となるテーブル上の特権によってではなくVIEW上の特権によって制御 されます。

6. VIEWの基本となるテーブルが削除された場合、VIEWを検索すると、テーブルが存在 しないと言うエラーメッセージを表示します。

   テーブルが削除される場合、VIEWが存在することの警告は与えられません。

7. VIEWの構造はDISPLAY TABLEコマンドを使用して表示することができます。 DISPLAY TABLEコマンドのALLオプションが指定されると、VIEWを 作成するために使用されたるSELECTコマンドが表示されます。

8. VIEWは論理的な仮想のテーブルです。テーブルに使用できるコマンドの多くはVIEW 上で使用することができます。それらのコマンドは以下のとおりです。
   
   
   • CREATE COMMENT
   • CREATE RANGE CHECK
   • CREATE REFERENTIAL CONSTRAINTS
   • DROP REFERENTIAL CONSTRAINTS
   • DELETE
   • DISPLAY
   • DROP COMMENT
   • DROP RANGE CHECK
   • DROP TABLE
   • DROP VIEW
   • GRANT/REVOKE PRIVILEGE
   • INSERT
   • RENAME
   • RUN REPORT
   • SELECT
   • UPDATE

   VIEWに使用できないコマンドは次のとおりです。ALTER, CREATE INDEX, DROP INDEX, EMPTY, LOCK LEVEL, SORT.

9. レコードは、VIEWから検索できます。しかし、更新系の処理はは、ある条件を満た すVIEWに制限されます。シンプルなVIEWは通常条件を満たします。

   以下に、EmpressがVIEWに対する更新系の操作を許可する条件を示します。

   この条件は3つの規則で表現することができます。

   • 条件が次のもののうちの1つである場合、VIEWを更新するために使用される WHERE句は、条件のAND接続に制限されているに違いありません。
     • フィールドと定数の比較。
     • 同一テーブルの2つのフィールド間の比較。
     • 異なるテーブルの2つのフィールドの一致条件。

     次のものは除外します。

     • NOT条件。
     • OR接続。
     • テーブル間の一致(=)以外の比較。

   • 基本テーブルのフィールド間の一致条件が必要です。テーブル対テーブルは1対1で 結合されていなくてはなりません。

   • 基本テーブルには、他のテーブルとのジョインに含まれているフィールドの中に、 最低1つのキーがなければなりません。これはインデックスが必要であることを意味 します。

     VIEW上で許可される更新系操作のための第2の条件は、ジョインするための フィールド間の同等条件のグループごとに各1つだけのフィールドがVIEWに選択されて いることです。この条件で更新した場合には、VIEWの更新により各基本テーブルの 各フィールドがそれぞれ更新されます。

   第２の条件は、等しい基本テーブル中のフィールドのすべてのセットについては、 1つだけがVIEWに選択されます。VIEWが更新される場合、そのようなセット中のすべて のフィールドは、同じ値で更新されます。

   第３の条件はNOT NULLを指定したフィールドかユニークなインデックスを 持ったフィールドと関係しているということです。

必要な特権

例

1. シンプルなVIEWの作成

   personnelテーブルのnameフィールドとphone フィールドを使用して、employeesというシンプルなVIEWを作成します。

      CREATE VIEW employees AS
         SELECT name, phone FROM personnel;
   
   

   以下のコマンドを実行します。

      SELECT * FROM employees;
   
   

   このように表示されます。

      name          phone
   
      Kilroy        426-9681
      Mosca         544-2243
      Wladislaw     723-6073
      Jones         667-2951
      Peterson      978-6060
      Scarlatti     961-7363
      Jordan        964-3335
   
   

   DISPLAY TABLEコマンドでVIEWの構造を表示できます。

      DISPLAY employees;
   
      *** View: employees ***
   
      Attributes:
        name          char(25,1)
        phone          char(15,1)
   
   

   DISPLAY TABLEコマンドにALLオプションを指定すると、VIEWを 作成したSELECTコマンドを参照できます。

      DISPLAY employees ALL;
   
      *** View: employees ***
   
      View: select attr 'name', attr 'phone' from 'personnel'
   
      Attributes:
        name          char(25,1)
        phone          char(15,1)
   
      Creator: joe
   
      Table #: 11
      Records: 7
   
   

2. 複雑なVIEWの作成

   VIEWを作ることが便利である理由は、2つ以上のテーブルからジョインする場合に、 VIEWを一度作成してしまえば毎回SELECTコマンドでジョインンする必要が なくなるからです。例えば、Jonesのローンおよび信用限度を示すためにloans テーブルとpersonnelテーブルからjonesloansという名前のVIEWを 作成するには、以下のコマンドを実行します。

      CREATE VIEW jonesloans AS
         SELECT name, date, amount, credit_limit
         FROM loans, personnel
         WHERE loans.name = 'Jones' AND
         loans.name = personnel.name;
   
   

DROP VIEWコマンドはデータディクショナリーからVIEWを削除します。

Syntax

DROP [VIEW] view;

where:

view	VIEWテーブル名。

注意

VIEWの削除では警告メッセージは表示されません。

必要な特権

DROP特権

例

jonesloansというVIEWを削除します。

   DROP VIEW jonesloans;

CREATE COMMENTコマンドはテーブル、フィールド、モジュール、ルーチン あるいはトリガにコメントを作成します。コメントは、DISPLAY DATABASEか DISPLAY TABLEコマンドで表示できます。

Syntax

Syntax 1:

CREATE COMMENT [ON]

|TABLE |ATTR[IBUTE] |MODULE |ROUTINE |TRIGGER

table table.attr module module.routine trigger

| [SET] comment_string; | | | |

Syntax 2:

COMMENT [ON]

|TABLE |ATTR[IBUTE] |MODULE |ROUTINE |TRIGGER

table table.attr module module.routine trigger

| [IS] comment_string; | | | |

説明

module	パーシスタントストアドモジュール名。
routine	ルーチン名。モジュール名を先行させ指定します。Empressキーワード として扱われるため、引用符で囲む必要があります。
trigger	トリガ名。
comment_string	引用符で囲まれた文字列。

注意

1. フィールドにコメントを作成する場合は、テーブル名を指定しなければいけま せん。

2. CREATE COMMENTはVIEWにも使用できます。

3. モジュール内の同じ名前を持ったルーチンは、外部名が違う場合でも共通の コメントを共有します。

必要な特権

ALTER特権

例

1. テーブルにコメントを作成します。

   loansテーブルにコメントを作成します。

      COMMENT ON TABLE loans IS "Loans to Employees";
   
   

   DISPLAY TABLEコマンドでコメントが表示されます。

      DISPLAY loans;
   
      *** Table: loans ***
   
      Comment: Loans to Employees
   
      Attributes:
   
        number             integer
        name               char(25,1)
        date               date(1)
        amount             dollar(6,1)

2. フィールドにコメントを作成します。

   loansテーブルのamountフィールドにコメントを作成します。

   CREATE COMMENT ON ATTRIBUTE loans.amount
       SET 'Amounts must be multiples of $$25';
   
   

   2つのドル($)記号は、Empress変数の解釈を回避させるのに必要です。詳細は Variables and Stringsの Empress Conventionsを参照してください。

   DISPLAY TABLEコマンドにALLオプションを指定すると コメントが表示されます。

      DISPLAY loans ALL;
   
      *** Table: loans ***
      
      Comment: Loans to Employees
      
      Attributes:
      
        number             integer
        name               char(25,1)
        date               date(1)
        amount             dollar(6,1)
      
      Comment: Amounts must be multiples of $25
      
      Creator: joe
      Lock Level: RECORD
      
      Table #: 8
      Records: 12
      Record size: 36
   
   

   特定のフィールドに関するコメントは、フィールドを指定した DISPLAY TABLEで表示することができます。

      DISPLAY loans ON amount ALL;
      
      *** Table: loans ***
      
      Comment: Loans to Employees
      
      Attributes:
      
        amount        dollar(6,1)
      
      Comment: Amounts must be multiples of $25
      
      Creator: joe
      Lock Level: RECORD
      
      Table #: 8
      Records: 12
      Record size: 36
   
   

DROP COMMENTコマンドはテーブルまたはフィールドからコメントを削除 します。

Syntax

DROP COMMENT [ON]	|TABLE |ATTR[IBUTE] |MODULE |ROUTINE |TRIGGER	table table.attr module module.routine trigger	|; | | | |

注意

DROP COMMENTコマンドは同様にVIEWのコメントも削除できます。

必要な特権

ALTER特権

例

loansテーブルからコメントを削除します。

   DROP COMMENT ON TABLE loans;

GRANT PRIVILEGEコマンドは、テーブルのアクセス特権をユーザに 与えます。特権を与えられたユーザもまた他のユーザに特権を与えることも可能です。 特権の削除はREMOVE PRIVILEGEコマンドで、表示は DISPLAY PRIVILEGEコマンドとDISPLAY GRANT PRIVILEGEコマンドで 行なえます。

Syntax

GRANT privilege {, privilege} [ON] table [TO] grantee {, grantee}

   [AS grantor] [[WITH] GRANT [OPTION]];

説明

privilege	Table 4-3にリストされたいずれか１つ。
grantee	いすれか１つ。 |CREATOR |DBA |PUBLIC |username | | | | 特権を付与されるユーザ名。CREATORはテーブル作成者。 DBA はデータベース管理者。PUBLICは全てのユーザ。username はシステムのログイン名またはアカウント名です。
grantor	いずれか１つ。 |CREATOR |DBA |username | | | 特権を付与するユーザ名。grantorを指定しない場合、 省略値はコマンドを発行したユーザ名となります。

注意

1. 特権を以下に示します。

   Table 4-3: データベース特権

   特権	許可されるコマンド
   ALTER	ALTER TABLE, CREATE/DROP COMMENT, CREATE/DROP RANGE CHECK, CREATE/DROP REFERENTIAL CONSTRAINT, LOCK LEVEL, RENAME
   BYPASS_LOCK	SELECT BYPASS_LOCK
   DELETE	DELETE, SELECT
   DISPLAY	DISPLAY TABLE
   DROP	DROP TABLE
   EMPTY	EMPTY TABLE
   INDEX	CREATE/DROP INDEX
   INSERT	INSERT
   SELECT	SELECT
   SORT	SORT
   UPDATE [(attr {, attr})]	UPDATE, SELECT フィールドが指定された場合、特権は 指定フィールドのみ有効となります。

2. いくつかの特権を集めたグループ名で指定できます。グループ名には DBA(管理者)、ALL、USERがあります。

   Table 4-4: データベース特権グループ

   特権タイプ	特権
   DBA	ALTER, DROP, EMPTY, INDEX, SORT
   ALL	All privileges.
   USER	BYPASS_LOCK, DELETE, DISPLAY, INSERT, SELECT, UPDATE

3. DBAは変数 MSDBADMINISTRATORによってtabzeroに定義されます。 テーブルのCREATORはデータ・ディクショナリー中の sys_tablesに定義されます。

   データベースのDBAおよびテーブルのCREATORは、適切な システムデータの更新により変更されます。DBAおよびCREATORの 特権を与えることは、それらがDBAかCREATORになるとともにユーザ によって特権を継承する手段を提供します。

4. テーブルにアクセスしようとした場合、ユーザのアクセス権がチェックされます。 ユーザがテーブル作成者またはDBAならば、その立場の特権が適用されます。

5. CREATORまたはDBAは、テーブルの特権を付与できます。 特権の削除は特権を付与したユーザだけが実行できます。ただしCREATORと DBAは特権の付与者として削除が可能です。

6. GRANTORタイプは、特権の付与と削除を制御します。ディフォルトでは grantオプションにある特権だけ付与できます。

7. Empressは、各データベースが作成されているオペレーティングシステムによって セットされるファイル許可を使用します。Empressデータベース中のテーブルに アクセスするために、ユーザは適切なオペレーティング システムファイル許可および 適切なデータベース特権の両方を持っていなければなりません。 例えばUNIXでは、DBAは付与する特権に適合したファイル許可を他ユーザに 与えなくてはなりません。 ユーザがデータベース上で検索だけするのであれば、データベースのディレクトリに あるテーブルに対応するファイルについては読み取り許可があれば十分です。 ユーザがデータベースで更新系の操作をするのであればテーブルおよび システムテーブルに対応したファイルについて書き込み許可を与えられなければ なりません。これはchmodコマンドの使用により行うことができます。 (使用法はUNIXマニュアルを参照)。 ユーザがデータベース上の新しいテーブルを作成する必要があれば、データベースを 含んでいるディレクトリについての書き込み許可がユーザに与えられなくてはなりま せん。

8. DBAは、すべてのテーブル上の特権を付与することができます。この特権 を行使するには、譲渡者はAS DBAとして特権を与えられなければなりません。 データディクショナリーのtabzero中の管理変数MSDBDBAPRIVS の中にはテーブル上のデフォルト特権が設定されています。この変数の初期値は次の 特権を有します。

   Table 4-5: DBAの特権初期値

   Grantor	Grantee	Privilege	Grant Option
   DBA	DBA	DBA 特権: ALTER, DROP EMPTY, INDEX, SORT	GRANTオプションなし。
   DBA	DBA	USER 特権: BYPASS_LOCK, DELETE, DISPLAY, CREATOR, INSERT, SELECT, UPDATE	GRANTオプション付き。

9. テーブルの作成者は、そのテーブル上の特権をすべて付与することができます。 テーブルが作成される場合、コマンドを出すユーザはテーブルのCREATORに なります。データディクショナリーのtabzero中の管理変数MSDBPRIVS の中でテーブル上のデフォルト特権が設定されています。この変数の初期値は次の特権 を有します。

   Table 4-6: CREATORの特権初期値

   Grantor	Grantee	Privilege	Grant Option
   CREATOR	CREATOR	DBA 特権: ALTER, DROP EMPTY, INDEX, SORT	grantオプションはなし。
   CREATOR	username (作成者のログイン名)	USER 特権: BYPASS_LOCK, DELETE, DISPLAY, CREATOR, INSERT, SELECT, UPDATE	GRANTオプション付き。

10. 特権はテーブルと同様にVIEW上でも与えることが可能です。

必要な特権

譲渡者は付与したい特権のgrant権限が必要です。

例

1. 特定ユーザへの特権付与

   auto partsテーブル上のSELECT特権とINSERT特権を ユーザmoscaとkilroyに付与します。

      GRANT SELECT, INSERT ON 'auto parts'
         TO mosca, kilroy;
   
   

2. 特権を付与オプションを付けて付与

   ユーザofficeにcustomersテーブルのINSERT特権、 UPDATE特権、DELETE特権を作成者と同等に付与オプション を付けて付与します。

      GRANT INSERT, UPDATE, DELETE ON customers
         TO office
         AS CREATOR
         WITH GRANT OPTION;
   
   

3. 全ユーザに対して特権を付与

   customersテーブルのSELECT特権を全ユーザの作成者と同等に 付与します。

      GRANT SELECT ON customers
         TO PUBLIC
         AS CREATOR;
   
   

DISPLAY PRIVILEGEコマンドは指定されたテーブルのアクセス特権を表示 します。

Syntax

DISPLAY

|PRIVILEGE |PRIV

| table [ON [ATTR] |

|attr |[NOT] match_op pattern

|] |

[

|ALL |AS | |

|DBA |CREATOR |username

| | |

|]; | | |

説明

match_op	次のいずれか１つLIKE, MATCH, !MATCH, SMATCH, !SMATCH。
pattern	WHERE句で指定するパターン。引用符で囲む必要があります。
username	システムのログイン名またはアカウント名。

注意

1. ALLオプションを指定しないDISPLAY PRIVILEGEコマンドは、 指定したテーブルにあるユーザの特権を表示します。特権は画面の所定の位置に表示 され、全ての特権を保有している場合にはALLと表示されます。

2. 更新の特権があるフィールドとないフィールドがある場合には、更新可能な フィールド名を表示します。表示を特定フィールドに限定するにはON フィールド名またはパターンマッチのオプションを指定します。

3. ALLオプションを指定すると、ユーザの特権はそれを有する単位によって 分類されます。適用可能な場合、特権のリストは、USER、PUBLIC、 DBA、CREATORで表示されます。

4. AS DBAオプションを指定すると、ユーザがデータベース管理者であれば 特権が表示され、そうでなければ何も表示されません。

5. AS CREATORオプションを指定すると、ユーザがテーブル作成者であれば 特権が表示され、そうでなければ何も表示されません。

6. AS usernameオプションを指定すると、指定ユーザの特権が表示 されます。このオプションはDBAまたはCREATORの場合に有効です。

7. DISPLAY PRIVILEGEはVIEW上の特権を表示することが可能です。

必要な特権

なし

例

1. テーブルの特権を表示します。

   loansテーブルの自分の特権を表示します。

      DISPLAY PRIVILEGE loans;
   
   

   以下を表示します。

      ALL
   
   

2. 特権の分類を表示します。

   特権の分類を含めて表示します。

      DISPLAY PRIVILEGE loans ALL;
   
   

   以下を表示します。

      USER: delete display insert select update
      CREATOR: alter drop empty index sort
   
   

DISPLAY GRANT PRIVILEGEコマンドは、指定されたテーブルの付与できる 特権の情報を表示します。

Syntax

DISPLAY GRANT

|PRIVILEGE |PRIV

| table [ON [ATTR] |

|attr |[NOT] match_op pattern

|] |

[

|ALL |AS | |

|DBA |CREATOR |username

| | |

|]; | | |

説明

match_op	次のいずれか１つLIKE, MATCH, !MATCH, SMATCH, !SMATCH。
pattern	WHERE句で指定するパターン。引用符で囲む必要があります。
username	システムのログイン名またはアカウント名。

注意

1. ALLオプションを指定しないDISPLAY GRANT PRIVILEGEコマンド は、指定したテーブルにあるユーザの付与できる特権を表示します。特権は画面の所定 の位置に表示され、全ての特権を付与できる場合にはALLと表示されます。

2. 更新の特権を付与できるフィールドとないフィールドがある場合には、付与できる 更新可能なフィールド名を表示します。表示を特定フィールドに限定するには ON フィールド名またはパターンマッチのオプションを指定します。

3. ALLオプションを指定すると、ユーザの付与できる特権はそれを有する 単位によって分類されます。適用可能な場合、付与できる特権のリストは、 USER、PUBLIC、DBA、CREATORで表示されます。

4. AS DBAオプションを指定すると、ユーザがデータベース管理者であれば 付与できる特権が表示され、そうでなければ何も表示されません。

5. AS CREATORオプションを指定すると、ユーザがテーブル作成者であれば 付与できる特権が表示され、そうでなければ何も表示されません。

6. AS usernameオプションを指定すると、指定ユーザの付与できる 特権が表示されます。このオプションはDBAまたはCREATORの場合に 有効です。

7. DISPLAY GRANT PRIVILEGEはVIEW上の付与できる特権を表示することが可能です。

必要な特権

なし

例

1. 付与できる特権を表示します。

   loansテーブルに対する付与できる特権を表示します。

      DISPLAY GRANT PRIVILEGE loans;
   
   

   以下を表示します。

      USER: delete display insert select update
   
   

2. 付与できる特権を詳細に表示します。

   付与できる特権の詳細を表示します。

      DISPLAY GRANT PRIVILEGE loans ALL;
   
   

   以下を表示します。

      USER: delete display insert select update
      CREATOR: all
      DBA: all
   
   

REVOKE PRIVILEGEコマンドはテーブルからユーザの特権を削除します。

Syntax

REVOKE privilege {, privilege} [ON] table [FROM] grantee {, grantee}

   [AS grantor];

説明

privilege	TABLE 4-3にリストされたいずれか１つ。
grantee	いずれか１つ。 |CREATOR |DBA |PUBLIC |username | | | | 特権を付与されたユーザ名。CREATORはテーブル作成者。DBAは デーベース管理者。PUBLICは全てのユーザ。usernameは システムのログイン名またはアカウント名。
grantor	いずれか１つ。 |CREATOR |DBA |username | | | 特権を付与するユーザ。grantorが指定されない場合、 省略値はコマンドの発行者となります。

注意

1. 3つの特権タイプ(DBA,ALL,USER)があります。 Table 4-4に示しています。

2. 付与者によって与えられた特権は、同じ付与者によって削除できます。しかしなが ら、CREATORおよびDBAは、どんな特権も無効にすることができます。

3. 特権はテーブル同様に、VIEW上でも与えたり削除することができます。

必要な特権

削除する特権の付与者でなくてはなりません。

例

auto partsテーブル上のユーザmoscaが持つINSERT 特権を削除します。

   REVOKE INSERT ON 'auto parts'
      FROM mosca;

LOCK LEVELコマンドは、テーブルのロックレベルを設定します。次に LOCK LEVELコマンドを発行するまでその設定は全ユーザに有効となります。

ロックレベルの設定は、マルチユーザシステムでデータベースを扱う場合の アクセス制御をすることを目的にしています。

Syntax

LOCK LEVEL [ON] table [IS]

|TABLE |GROUP [(n)] |RECORD [(n)] |NULL

|; | | |

注意

1. NULLが指定された場合、指定テーブルのロックは無効となります。

2. TABLEが指定された場合、SQLコマンドの処理中はテーブル全体がロック されます。

3. GROUPが指定された場合、SQLコマンドの処理中は処理している 全レコード（テーブル全体でない）をロックします。

   SQLコマンドの中で使用されたフィールドにインデックスが無ければ、グループの ロックレベルはテーブルのロックレベルと同一になります。

4. RECORDが指定された場合、SQLコマンドが処理する各レコードだけが ロックされます。

5. RECORD (n)を指定された場合、SQLコマンドが処理する各レコードの 前後(n-1)分のレコードをロックします。

6. VIEWにロックレベルを設定しても効果はありません。

7. テーブルが作成された時に設定されるロックレベルは、データディクショナリー tabzeroファイル中のシステム変数MSDBLOCKLEVELによて制御され ます。初期値はRECORDレベルです。

   必要な特権

   ロックするテーブルにALTER特権が必要です。

   例

   1. テーブルのロックを無効にします。

      personnelテーブルのロックレベルをNULLにします。

         LOCK LEVEL ON personnel IS NULL;
      
      

   2. テーブルにレコードレベルのロックを設定します。

      loansテーブルをレコードレベルのロックに設定します。

         LOCK LEVEL ON loans IS RECORD;
      
      

The CREATE MODULEコマンドはデータ・ディクショナリーへPSM (Parsistant Stored Module)モジュールの定義を格納するために使用されます。 これは、ユーザに定義された機能、オペレーター、手続きあるいは総計機能のための エントリーポイントを作成します。UPDATE MODULEコマンドは、モジュール 定義をモジュールロード可能なシェアードライブラリとリンクするために必要です。

Syntax

CREATE MODULE module_name

   [LANGUAGE C [(lang_param {, lang_param})]]

|module_procedure |module_function |module_operator |module_agg_func

|; { | | |

|module_procedure |module_function |module_operator |module_agg_func

|;} | | |

   END MODULE;

説明

module_name	モジュール名。
lang_param	現在、Empressで使用していません。
module_procedure	以下の定義を行ないます。 [DECLARE] PROCEDURE procedure_name ([[| IN |] [parameter_name] parameter_type | OUT | |INOUT| {, [| IN |] [parameter_name] parameter_type}]) | OUT | |INOUT| [ALLOCATE WORKSPACE | nbytes |] | variable | EXTERNAL [BEGIN EXPRESSION external_routine_name] [NAME external_routine_name] [END EXPRESSION external_routine_name] [|PARAMETER STYLE SQL |] |PARAMETER STYLE GENERAL|
module_function	以下の定義を行ないます。 [DECLARE] FUNCTION function_name ([[IN] [parameter_name] parameter_type {, [IN] [parameter_name] parameter_type}]) RETURNS return_type [ALLOCATE WORKSPACE | nbytes |] | variable | EXTERNAL [BEGIN EXPRESSION external_routine_name] [NAME external_routine_name] [END EXPRESSION external_routine_name] [|PARAMETER STYLE SQL |] |PARAMETER STYLE GENERAL|
module_operator	以下の定義を行ないます。 [DECLARE] OPERATOR |PREFIX |POSTFIX |INFIX [precedence] |COMPARISON |EQUALITY | operator_name | | | | ([[IN] [parameter_name] parameter_type {, [IN] [parameter_name] parameter_type}]) RETURNS return_type [ALLOCATE WORKSPACE | nbytes |] | variable | EXTERNAL [BEGIN EXPRESSION external_routine_name] [NAME external_routine_name] [END EXPRESSION external_routine_name] [|PARAMETER STYLE SQL |] |PARAMETER STYLE GENERAL|
module_agg_func	以下の定義を行ないます。 [DECLARE] AGGREGATE FUNCTION aggr_function_name ([IN] parameter_name] parameter_type {, [IN] [parameter_name] parameter_type}) RETURNS return_type [ALLOCATE WORKSPACE | nbytes |] |variable| EXTERNAL [BEGIN EXPRESSION external_routine_name] BEGIN GROUP external_routine_name BODY external_routine_name END GROUP external_routine_name [END EXPRESSION external_routine_name] [|PARAMETER STYLE SQL |] |PARAMETER STYLE GENERAL|

注意

1. EmpressのPSMには、現在Cプログラミング言語だけがサポートされて います。今後、他の言語がサポートされるかもしれません。

   Cプログラミングでの記述は大文字、小文字両方とも可能です。

2. パラメータモードとしてIN、OUT、INOUTがあり それぞれ入力、出力、入出力となります。省略値はINです。

3. parameter_typeには3種類のグループがあります。

   MSデータタイプ	Empress SQLデータタイプです。 データタイプを参照してください。
   汎用データタイプ	Empress汎用データタイプです。Empress: ユーザ定義関数 のData Type Correspondences を参照してください。
   Cデータタイプ
   Cプログラミング言語のデータタイプです。 データタイプの前に、キーワードCを付け、引用符で囲まなくてはなりま せん。"C long"

   パラメータは違うグループの混在も許可します。

        (number "C long",
         string CHAR,
         amount GENERIC FLOAT)
   
   

4. return_typeは、parameter_typeのように 異なるグループを持つ可能性があります。

5. 以下に示す5つのオペレータークラスがあります。

   • PREFIX
   • POSTFIX
   • INFIX [precedence]
   • COMPARISON
   • EQUALITY

   INFIXオペレータークラスのprecedenceは、1, 2,3,4,5,6, right。 booleanオペレターは、1,2のみ有効、省略値は2です。 数学オペレーターは、すべて、省略値は4です。

6. パラメータスタイルは、PARAMETER STYLE GENERALまたは PARAMETER STYLE SQLです。省略値はPARAMETER STYLE GENERALです。

7. 下記に、手続き、機能、オペレーターおよび統計機能に説明します。

   名前のルール

   • データベース中には同一のモジュール名は許可されません。
   • モジュールの中には、
     • パラメータが違えば同一名のルーチンは許可されます。
     • BEGIN EXPRESSIONBEGIN EXPRESSIONの同一の外部ルーチン名は許可 されます。
     • BEGIN GROUPBEGIN GROUPの同一の外部ルーチン名は許可されます。
     • BODYBODYの同一に外部ルーチン名は許可されません。
     • END GROUPEND GROUPの同一の外部ルーチン名は許可されます。
     • END EXPRESSIONEND EXPRESSIONの同一の外部ルーチン名は許可され ます。
   • モジュールを横切る同一のルーチン名は許可されません。

   モジュール名、ルーチン名および外部名の前方または後方のブランクは無視され ます。先頭はアンダースコア(_)または、英字で始まり、アンダースコアまたは英数字 で構成され、最大31文字以内で構成されなくてはなりません。

8. external_routine_nameは５つに分類されます。

   • external begin expressionルーチン名
   • external begin groupルーチン名
   • external bodyルーチン名
   • external end groupルーチン名
   • external end expressionルーチン名

   集計関数は5つ全てのクラスが存在しますが、他のルーチンではbegin groupと end groupは存在しません。

   外部BODYルーチン名は、統計機能と他のルーチン用の外部名節のために、 (NAME)とBODY節(BODY)によって指定されます。 省略時の外部BODY名はルーチン名と同じです。

   External begin groupとend groupルーチン名は、統計関数のために指定されます。 一般的にbegin group expressionルーチン名はリターン値のために、初期化と end groupルーチンで使用されます。

9. ALLOCATE WORKSPACEが指定された場合、Empressは自動的に PSMのために作業用スペースの確保と開放を行ないます。

   変数名がworkspaceに対して与えられる場合、外部ルーチンの中で同一の変数名を 定義しなくてはなりません。

10. CREATE MODULEが完了したら手続き、機能、オペレーター、統計機能を 使用するためにはモジュール定義をモジュールロード可能なシェアードライブラリと リンクするために、UPDATE MODULEを実行しなくてはなりません。

11. 詳細は、ユーザ定義関数マニュアルの Persistent Stored Modules (PSM)を参照してください。

必要な特権

DBA特権

例

1. 次の例はモジュール手続きprocmoduleを作成します。 例の手続きlog_eventはaudit trail logを作成するために使用されます。

      CREATE MODULE procmodule
         PROCEDURE log_event ()
            EXTERNAL;
         END MODULE;
   
   

2. 次の例はモジュール関数funcmoduleを作成します。このモジュール 機能は2つの機能replacenullとroundupを宣言します。

   例の関数replacenullは、NULL値を指定された文字列に変換 します。関数roundupは、指定された10進数字を四捨五入します。

      CREATE MODULE funcmodule
         FUNCTION replacenull (stringvalue CHAR, defaultstring CHAR)
            RETURNS CHAR
            EXTERNAL;
         FUNCTION roundup (number GENERIC FLOAT, digits GENERIC FLOAT)
            RETURNS GENERIC FLOAT
            EXTERNAL;
         END MODULE;
   
   

   replacenullとroundup関数がEmpressの組込み関数 nullvalとroundと同じものであることに注意してください。 nullvalおよびroundは、この例の中で使用することができない Empressキーワードです。

3. 次の例はモジュール・オペレーターopermoduleを作成します。 例のオペレーターconcatenationは文字データを連結します。この オペレーターはEmpressオペレーターconcatと同じものです。

      CREATE MODULE opermodule
         OPERATOR INFIX concatenation 
            (str1 "C char", str2 "C char")
            RETURNS "C char"
            EXTERNAL;
         END MODULE;
   
   

4. 次の例はモジュール集計関数aggrmoduleを作成します。 例の集計関数ssdは、集計のxデータの2乗された標準偏差に関連した最終の 総計の値を算出します。

      CREATE MODULE aggrmodule
         AGGREGATE FUNCTION ssd (LONGFLOAT)
            RETURNS LONGFLOAT
            ALLOCATE WORKSPACE somespace
            EXTERNAL BEGIN GROUP ssdigrp
                     BODY ssdrfns
                     END GROUP ssdtgrp;
         END MODULE;
   
   

   例中の外部ルーチンは、EMPRESS: ユーザ定義関数を参照してください。

UPDATE MODULEコマンドはモジュール定義をモジュールロード可能な シェアードライブラリとリンクします。

Syntax

UPDATE MODULE module_name [FOR system_name] [|FROM | dll_file]; |USING|

説明

module_name	モジュール名。
system_name	Empress RDBMSライセンスで有効なシステムID。
dll_file	動的にロード可能なシェアードライブラリオブジェクトファイル名。

注意

1. PSMルーチンのインプリメンテーションを備えたモジュールを更新するために、 UPDATE MODULEコマンドは、FROM dll_fileか USING dll_fileオプションと共に通常使用されます。

2. モジュールが、古いバージョン(例えばバージョン8.20)からより新しい バージョン(例えばバージョン8.62)に変換される場合、その古いwrap.dllは 新バージョン上で実行することができません。 データベースがより新しいバージョンに改良される場合のみ、FROM dll_file かUSING dll_fileオプションのないUPDATE MODULEコマンドを使用 してください。 この場合、与えられたモジュール用のwrap.dllファイルを再生成します。

3. モジュールが動的なロード可能なシェアードライブラリオブジェクトファイル の内容かパスが変更された場合、UPDATE MODULEコマンドを使用することが できます。

4. system_nameは以下のコマンドで取得できます。

      empvers
   
   

   上記コマンドはシステムプロンプトで実行し、以下のような表示がされます。

     EMPRESS V8.62
     (c) Copyright Empress Software Inc. 1983, 2002
   for Intel x86 running Linux OS Release 2.0 with libc.so.6 (ELF)
   [linux-libc6-x86]
   Port Code DOCS-08.62-A-00-S-ENG
   Port Code DOSV-08.62-A-00-S-ENG
   Port Code HYPM-08.62-A-00-S-ENG
   Port Code JDBC-08.62-A-00-S-ENG
   Port Code ODBC-08.62-A-00-S-ENG
   Port Code RDBM-08.62-A-00-S-ENG
   Installed in: /home/staff/joe/empress/v8.62
   
   

   システム名は、鍵括弧で囲まれた中に示されます。linux-libc6-x86

必要な特権

DBA特権

例

下記コマンドは、動的なロード可能なシェアードライブラリオブジェクトファイル procmodule.dllからのモジュールprocmoduleを更新します。

   UPDATE MODULE procmodule FROM 'procmodule.dll';

DROP MODULEコマンドはデータベースデータディクショナリーから モジュール定義を削除します。モジュールに定義されるどんな機能、手続き、 オペレーターおよび総計機能も使用できなくなります。

Syntax

DROP MODULE module_name;

説明

module_name

モジュール名。

注意

モジュール削除には警告メッセージは表示されません。

必要な特権

DBA特権

例

下記は、procmoduleという名前のモジュールを削除します。

   DROP MODULE procmodule;

DISPLAY MODULEコマンドは、データベースデータディクショナリーからの モジュール定義を表示します。

Syntax

DISPLAY MODULE [module_name] [ALL] [DUMP] [

|INTO |ONTO

| file]; |

説明

module_name

モジュール名。

注意

1. モジュール名が指定されない場合、DISPLAY MODULEコマンドは データベース中のすべてのモジュールの定義を表示します。

2. ALLオプションのないDISPLAY MODULEコマンドは、 このモジュールが利用可能なシステム、モジュール中のすべてのSQLで起動する ルーチンおよびそれらの外部名前を表示します。

   モジュールがどのシステムにも有効でない場合(NONE表示)は、作成されたが リンクされていない(UPDATE MODULEコマンドで)ことを意味します。

3. DISPLAY MODULEコマンドにALLオプションを指定すると、 次のモジュールについての補足情報を提供します。パラメーター情報、 リターンデータタイプ、パラメータースタイル、モジュールの作成者、 モジュール番号、モジュールを作成したプログラミング言語(現在はCプログラミング 言語のみです)。

4. DUMPが指定された場合、出力は圧縮され、スクリプトファイルを 作成するために使用することができます。

5. INTO fileまたはONTO fileが指定された 場合、出力はターミナルへではなく指定されたファイルへ送られます。 ONTOは追記しますがINTOはファイルに上書きします。 またどちらもファイルが存在しない場合はファイルを作成します。

必要な特権

DISPLAY特権

例

以下に表示の違うDISPLAY MODULEコマンドを示します。

   * DISPLAY MODULE;
   
     aggrmodule
     funcmodule
     opermodule
     procmodule

   
   * DISPLAY MODULE funcmodule;
   
     ****  Database: repairs  ****
   
     ***  Module: funcmodule  ***
   
         Available for systems:
           NONE
   
         replacenull                     function
           External Name:                  replacenull
   
         roundup                         function
           External Name:                  roundup

   
   * DISPLAY MODULE ALL;
   
     ****  Database: repairs  ****
   
     ***  Module: aggrmodule  ***
   
         Available for systems:
           NONE
   
         ssd                             aggregate function
   
     ***  Module: funcmodule  ***
   
         Available for systems:
           NONE
   
         replacenull                     function
         roundup                         function
   
     ***  Module: opermodule  ***
   
         Available for systems:
           NONE
   
         fact                            postfix operator
   
     ***  Module: procmodule  ***
   
         Available for systems:
           NONE
   
         log_event                       procedure

   
   * DISPLAY MODULE funcmodule ALL;
   
     ***  Module: funcmodule  ***
   
         Available for systems:
           NONE
   
         replacenull                     function
           Number of Parameters:           2
                1)   in      stringvalue         character(25,1)
                2)   in      defaultstring       character(25,1)
           Return Data Type:               character(25,1)
           Parameter Style:                general
           External Name:                  replacenull
   
         roundup                         function
           Number of Parameters:           2
                1)   in      number              generic float
                2)   in      digits              generic float
           Return Data Type:               generic float
           Parameter Style:                general
           External Name:                  roundup
   
         Creator:         zsu
         Module #:        2
         Language:        C

   
   * DISPLAY MODULE DUMP;
   
     aggrmodule
     funcmodule
     opermodule
     procmodule

CREATE TRIGGERコマンドはデータベースデータディクショナリーへ トリガ定義を作成します。

Syntax

CREATE TRIGGER trigger_name

|BEFORE |AFTER

| |

|DELETE |INSERT |UPDATE [ OF (attr {, attr})] |SELECT [ OF (attr {, attr})]

| {, | | |

|DELETE |INSERT |UPDATE [ OF (attr {, attr})] |SELECT [ OF (attr {, attr})]

| } | | |

   ON table [FOR EACH ROW [when_clause]]

   EXECUTE procedure_name;

説明

trigger_name	トリガ名。トリガの命名規約はテーブル名、フィールド名と同様です。
when_clause	以下のシンタックスです。 WHEN |b_expr |(b_expr) |b_expr AND b_expr |b_expr OR b_expr |NOT b_expr | | | | | b_exprはブール式です。ブール式の詳細はWHERE句を参照してください。 サブクエリーはサポートしていません。 フィールド名の前にはNEW.またはOLD.が付けられます。 参照フィールドは、トリガが作成されたテーブルから行なわれます。
procedure_name	PSM (パーシスタントストアドモジュール)のプロシージャ名です。

注意

1. トリガを作成する時に指定するprocedure_nameは、CREATE MODULEコマンドで定義されていない場合にはエラーメッセージを表示します。

   トリガを使用する前には、UPDATE MODULEを発行する必要があります。 発行しないとprocedure_nameが存在しない旨のエラーメッセージを表示 します。

2. トリガのためのprocedureはパラメーターのないPSMプロシージャ です。パラメーターを備えたモジュールprocedureがCREATE TRIGGER コマンドと共に使用されると、エラーメッセージを表示します。

3. FOR EACH ROWオプションなしで作成されるトリガはステート メントトリガと呼ばれます。SQLコマンドが実行され、オペレーションが複数の レコードに適用される場合でも、それはファンクションを起動します。

   FOR EACH ROWオプションで作成されるトリガは列トリガと 呼ばれます。オペレーションがデータのレコードに適用されるごとに、それは ファンクションを起動します。

4. トリガはステートメント/オペレーション(INSERT、DELETE、 UPDATE)が列/レコードの上で試みられる前、あるいはオペレーションが完了 した後に、明示することができます。 SELECTトリガの場合には、SELECT操作が完了した後だけに、 明示することができます。

5. UPDATEおよびSELECTトリガは対応する複数のフィールドを指定する ことができます。フィールドが指定されない場合、テーブル内の全てのフィールドが 対象となります。

6. when_clauseはFOR EACH ROWオプションに関係しています。 FOR EACH ROWがCREATE TRIGGERコマンドの中で指定されていない 場合、when_clauseは割り当てることができません。 一旦アクセスされたレコードがwhere_clauseの条件を満たす場合、 FOR EACH ROWオプションのために割り当てられたトリガが有効となります。

7. when_clauseの指定はWHERE句の指定と似ています。サブクエリーは サポートされていません。

8. when_clauseの中でフィールド値を使用する場合。

   • UPDATEトリガについては、INSERTトリガのために既存の フィールド値(次のように指定された old.attr)、および新しい フィールド値(次のように指定されたnew.attr)を参照します。
   • INSERTトリガについては、新しいフィールド値を単に参照することが できます。既存のフィールド値は意味がありません。
   • BEFORE DELETEトリガについては、既存のフィールド値を単に参照 することができます。新しいフィールド値は意味がありません。
   • AFTER DELETEトリガについては、既存のフィールド値も新しい フィールド値も意味があります。
   語句を間違えた場合、エラーメッセージは表示されません。また、フィールド値は NULLとして扱われます。

9. updateトリガを使用する場合。

   • 列トリガについては、トリガが起動されるかどうかは既存のレコード および新しい値を比較して決定されます。複数のフィールドが指定された場合指定 されたフィールドだけがチェックされます。フィールドの指定がない場合は全ての フィールドがチェックされます。対応する値が同じである場合、トリガは起動されません。
   • ステートメントトリガについては、値がチェックされずにトリガを起動 します。値が更新の前後でに同じでも、トリガは起動されます。

10. テーブル名およびフィールド名(RENAMEコマンドによる)の変更は既存 のトリガに効果がありません。トリガは、新しい名前のもとで正確に自動的に機能 します。

11. フィールドの変更(ALTER TABLEコマンドによる)より、テーブルを 変更してもトリガに効果がありません。トリガは、新しいテーブル構造のもとで正確に 自動的に機能します。フィールドが削除された場合、設定されたトリガはすべて削除 されます。

12. トリガはVIEWに対しても有効です。

13. トリガは、ALTER TABLEコマンドの使用により一時的に無効にしたり 有効にしたりできます。トリガの作成時は自動的に有効となります。

14. 多数のトリガが同じ出来事のために作成される場合、トリガ定義内の優先度は 実行されるトリガ手続きの順序を決定します。トリガが作成される場合、優先度は 0.000にセットされます。トリガの優先度を変更する場合はALTER TABLE コマンドを使用します。

15. トリガ定義はDISPLAY TABLE table_name ALLコマンドによって表示 できます。

必要な特権

ALTER特権

例

loansテーブルが更新される場合のトリガ、history_logを 作成します。手続きlog_eventは更新を記録するために実行されます。

最初のステップはユーザに定義された手続きを作成することです。この例における 手続きは以下に示すuser.c内にあります。

   #include   <usrfns.h>
   #include   <time.h>
   
   static void  print_rec (void*   mr,
                           void*   rec,
                           char*   tag)
   {
      extern  char*   mrganame (addr);
   
      void*           attr;
      int             i;
      char*           val;
   
      for (i = 1; ; ++i)
      {
         attr = mrigeta (mr, i);
         if (attr == 0)
         break;
   
         val = mrgetvs (rec, attr);
         if (val == 0)
            val = "(NULL)";
   
         printf ("\t%s %s = '%s'\n",
                  tag, mrganame (attr), val);
      }
   }
   
   static void  trigger_proc (char*  procname)
   {
      extern  char*   mrgname ();
      extern  int     strcmp ();
   
      time_t  t;
      void*   mr;
      void*   newrec;
      void*   oldrec;
      char*   s;
   
      mspsm_trig_get_record_info (& mr, & oldrec, & newrec);
   
      printf ("+++ Trigger Procedure +++  %s  for table '%s'\n",
               procname, mrgname (mr));
      time (& t);
      printf ("\ttime: %s", ctime (& t));
      if (oldrec == 0)
          printf ("\tNo Old Record\n");
      else
          print_rec (mr, oldrec, "Old");
      if (newrec == 0)
          printf ("\tNo New Record\n");
      else
          print_rec (mr, newrec, "New");
   }

   void    log_ins_upd_del ()
   {
       trigger_proc ("log_ins_upd_del");
   }

emppsmccコマンドでソースファイルuser.cをコンパイルして、共有される オブジェクトファイルuser.dllを作成します。

   emppsmcc -o user.dll user.c 

次のステップはモジュールおよびトリガを定義します。そして共有される オブジェクトファイルuser.dllをモジュール定義にリンクします。

   CREATE MODULE for_trigger
      PROCEDURE log_event ( ) 
      EXTERNAL NAME log_ins_upd_del;
   END MODULE;

   CREATE TRIGGER history_log BEFORE
      INSERT OR DELETE OR UPDATE
      ON loans FOR EACH ROW
      EXECUTE log_event;

   UPDATE MODULE for_trigger FROM 'user.dll';

表示コマンドを実行します。

   DISPLAY TABLE loans ALL;

以下の表示をします。

   *** Table: loans ***

   Attributes:
     number                integer
     name                  char(25,1)
     date                  date(1)
     amount                dollar(6,1)

   Triggers:
     history_log
       before
       insert or delete or update
       for each row
       execute log_event
       priority 0.000
       enable

   Creator: joe
   Lock Level: RECORD

   Table #: 8
   Records: 12
   Record size: 36

下記にトリガからのサンプル出力を示します。

   INSERT loans VALUES (5, 'Mosca', '2 Mar 1998', '999'
                        3, 'Jones', '7 Feb 1998', '800');

   +++ Trigger Procedure +++  log_ins_upd_del  for table 'loans'
           time: Tue Mar  3 10:55:49 1998
           No Old Record
           New number = '5'
           New name = 'Mosca'
           New date = '2 March     1998'
           New amount = '$999.00'
   +++ Trigger Procedure +++  log_ins_upd_del  for table 'loans'
           time: Tue Mar  3 10:55:49 1998
           No Old Record
           New number = '3'
           New name = 'Jones'
           New date = '7 February  1998'
           New amount = '$800.00'
   
   UPDATE loans SET amount = '999.99' WHERE date > '31 Dec 1997';

   +++ Trigger Procedure +++  log_ins_upd_del  for table 'loans'
           time: Tue Mar  3 10:55:49 1998
           Old number = '5'
           Old name = 'Mosca'
           Old date = '2 March     1998'
           Old amount = '$999.00'
           New number = '5'
           New name = 'Mosca'
           New date = '2 March     1998'
           New amount = '$999.99'
   
   DELETE loans WHERE amount > 800;

   +++ Trigger Procedure +++  log_ins_upd_del  for table 'loans'
           time: Tue Mar  3 10:55:49 1998
           Old number = '5'
           Old name = 'Mosca'
           Old date = '2 March     1998'
           Old amount = '$999.99'
           No New Record

上記のトリガがFOR EACH ROWオプションなしで定義された場合には、

   INSERT loans VALUES (5, 'Mosca', '2 Mar 1998', '999'
                        3, 'Jones', '7 Feb 1998', '800');

以下のような表示を行います。

   +++ Trigger Procedure +++  log_ins_upd_del  for table 'loans'
           time: Tue Mar  3 10:55:49 1998
           No Old Record
           New number = '5'
           New name = 'Mosca'
           New date = '2 March     1998'
           New amount = '$999.00'
           No Old Record
           New number = '3'
           New name = 'Jones'
           New date = '7 February  1998'
           New amount = '$800.00'

DROP TRIGGERコマンドはデータベースデータディクショナリーから トリガ定義を削除します。

Syntax

DROP TRIGGER trigger_name

説明

trigger_name

トリガ名。

注意

1. DROP TRIGGERはデータディクショナリーからトリガ定義を削除します。 トリガを削除しますがモジュール手続きは削除しません。モジュール手続きを削除する にはDROP MODULEを使用してください。

2. トリガ定義を削除する代わりにALTER TABLEコマンドの使用により 一時的にトリガを無効または有効になることができます。

必要な特権

ALTER特権

例

トリガhistory_logを削除します。

   DROP TRIGGER history_log;

loansテーブルのデータディクショナリーからトリガを削除します。

DISPLAY DATABASEコマンドは、データベースの名前、およびデータベース 中のテーブルの名前を表示します。

Syntax

DISPLAY

|DATABASE |DB

| [database] [ON [TABLE] |

|table |[NOT] match_op pattern

|] |

[ALL] [DUMP]

[

|INTO |ONTO

| file]; |

説明

match_op	次のいずれか１つLIKE, MATCH, !MATCH, SMATCH, !SMATCH。
pattern	WHERE句で指定するパターン。引用符で囲む必要があります。
file	ファイル名。

注意

1. キーワードDATABASEは、DBと指定することができます。

2. データベース名が指定された場合、指定されたデータベース中のテーブルの名 がリストされます。データベース名が指定されない場合、現在のデータベース中の テーブルの名がリストされます。

3. テーブル名が指定された場合、そのテーブルのための情報だけが表示され ます。パターン・マッチが指定された場合、パターンと一致するテーブルの情報が表示 されます。

4. ALLが指定された場合、データベース中の各ユーザに作成された テーブルの構造も表示されます。DUMPは単なるデータベース中のテーブル名 をリストして、簡潔な形式で表示します。ALLがDUMPと共に使用 される場合、テーブル定義を含んで簡潔な形式で表示します。

5. INTO fileまたはONTO fileが指定された 場合、出力はターミナルへではなく指定されたファイルへ送られます。ONTO は追記し、INTOは既存のファイルを上書きします。両方ともファイルが無い 場合には、ファイルを作成します。

6. データベースにテーブルがない場合、コマンドは単なるデータベースの名前を 表示します。

7. データベース中のテーブルと共に表示されます。

必要な特権

データベース自体を表示するのに特権は必要しないが、テーブルについては SELECT特権が必要となります。

例

1. データベース中の全てのテーブルを表示すます。

   以下のコマンドでデータベース中の全テーブルを表示します。

      DISPLAY DB;
   
   

   以下の表示を行います。

      **** Database: repairs ****
   
      auto parts
      customers
      loans
      personnel
   
   

2. 全てのテーブルについて構造も表示します。

   全てのテーブルについて構造も表示します。

      DISPLAY DB ALL;
   
   

   以下の表示を行います。

   
      ***Database: repairs ****
      
      *** Table: auto parts ***
      
      supplier            char(20,1) Not Null
      phone               char(8,1)
      part name           char(25,1)
      part no.            longinteger
      price               dollar(4,1)
      
      *** Table: customers ***
      
      name                char(20,1) Not Null
      address             text(30,124,30,1)
      comments            text(25,1,80,1)
      
      *** Table: loans ***
      
      number              integer
      name                char(25,1)
      date                date(1)
      amount              dollar(6,1)
      
      *** Table: personnel ***
      
      number              integer
      name                char(25,1)
      phone               char(15,1)
      credit_limit        dollar(6,1)
   
   

3. 指定されたテーブルの構造を表示します。

   loansテーブルの構造を表示します。

      DISPLAY DB ON loans ALL;
   
   

   以下の表示を行います。

      **** Database: repairs **** 
   
      *** Table: loans *** 
   
      number             integer
      name               char(25,1)
      date               date(1)
      amount             dollar(6,1)
   
   

4. データベース中の全てのテーブル名をファイルに保存します。

   下のコマンドで全テーブル名をdblistファイルへ保存します。

      DISPLAY DB INTO 'dblist';