COMMENT

目的

COMMENT文を使用すると、表または表の列、統合監査ポリシー、エディション、索引タイプ、マテリアライズド・ビュー、マイニング・モデル、演算子またはビューに関するコメントを、データ・ディクショナリに追加できます。

データベースからコメントを削除する場合、空の文字列' 'を設定します。

関連項目:

SQL文およびスキーマ・オブジェクトへのコメントの関連付けの詳細は、「コメント」を参照してください。
コメントを表示するデータ・ディクショナリ・ビューの詳細は、『Oracle Databaseリファレンス』を参照してください。

前提条件

コメントを追加するオブジェクトが自分のスキーマ内にある必要があります。自分のスキーマ内にない場合は、次の条件を満たす必要があります。

表、ビューまたはマテリアライズド・ビューにコメントを追加する場合は、COMMENT ANY TABLEシステム権限を持っている。
統合監査ポリシーにコメントを追加する場合は、AUDIT SYSTEMシステム権限またはAUDIT_ADMINロールが必要です。
エディションにコメントを追加する場合は、直接またはロールを介して付与されたCREATE ANY EDITIONシステム権限を持っている。
索引タイプにコメントを追加する場合は、CREATE ANY INDEXTYPEシステム権限を持っている。
マイニング・モデルにコメントを追加する場合は、COMMENT ANY MINING MODELシステム権限が必要です。
演算子にコメントを追加する場合は、CREATE ANY OPERATORシステム権限を持っている。

構文

comment::=

図comment.epsの説明

セマンティクス

AUDIT POLICY句

コメントする統合監査ポリシーの名前を指定します。

AUDIT_UNIFIED_POLICY_COMMENTSデータ・ディクショナリ・ビューを問い合せると、特定の統合監査ポリシーに対するコメントを表示できます。

COLUMN句

コメントする表、ビューまたはマテリアライズド・ビューの列の名前を指定します。schemaを指定しない場合、この表、ビューおよびマテリアライズド・ビューは自分のスキーマ内にあるとみなされます。

データ・ディクショナリ・ビューUSER_TAB_COMMENTS、DBA_TAB_COMMENTS、ALL_TAB_COMMENTS、USER_COL_COMMENTS、DBA_COL_COMMENTSまたはALL_COL_COMMENTSを問い合せることによって、特定の表または列に関するコメントを表示できます。

EDITION句

コメントする既存のエディションの名前を指定します。

データ・ディクショナリ・ビューALL_EDITION_COMMENTSを問い合せると、現在のユーザーがアクセスできるエディションに関連付けられたコメントを表示できます。DBA_EDITION_COMMENTSを問い合せると、データベース内のすべてのエディションに関連付けられたコメントを表示できます。

TABLE句

コメントする表またはマテリアライズド・ビューの名前とスキーマを指定します。schemaを指定しない場合、この表およびマテリアライズド・ビューは自分のスキーマ内にあるとみなされます。

ノート:

以前のリリースでは、この句を使用してマテリアライズド・ビューにコメントを作成できました。今回のリリースでは、マテリアライズド・ビューに、COMMENT ON MATERIALIZED VIEW句を使用する必要があります。

INDEXTYPE句

コメントする索引タイプの名前を指定します。schemaを指定しない場合、この索引タイプは自分のスキーマ内にあるとみなされます。

データ・ディクショナリ・ビューUSER_INDEXTYPE_COMMENTS、DBA_INDEXTYPE_COMMENTSまたはALL_INDEXTYPE_COMMENTSを問い合せることによって、特定の索引タイプに関するコメントを表示できます。

MATERIALIZED VIEW句

コメントするマテリアライズド・ビューの名前を指定します。schemaを指定しない場合、このマテリアライズド・ビューは自分のスキーマ内にあるとみなされます。

データ・ディクショナリ・ビューUSER_MVIEW_COMMENTS、DBA_MVIEW_COMMENTSまたはALL_MVIEW_COMMENTSを問い合せることによって、特定のマテリアライズド・ビューに関するコメントを表示できます。

MINING MODEL

コメントするマイニング・モデルの名前を指定します。

USER_MINING_MODELS、DBA_MINING_MODELSまたはALL_MINING_MODELSデータ・ディクショナリ・ビューのCOMMENTS列を問い合せると、特定のマイニング・モデルに対するコメントを表示できます。

OPERATOR句

コメントする演算子の名前を指定します。schemaを指定しない場合、その演算子は自分のスキーマ内にあるとみなされます。

データ・ディクショナリ・ビューUSER_OPERATOR_COMMENTS、DBA_OPERATOR_COMMENTSまたはALL_OPERATOR_COMMENTSを問い合せることによって、特定の演算子に関するコメントを表示できます。

IS 'string'

コメントのテキストを指定します。'string'の構文の詳細は、「テキスト・リテラル」を参照してください。

例

コメントの作成: 例

次の文は、employees表のjob_id列にコメントを挿入します。

COMMENT ON COLUMN employees.job_id 
   IS 'abbreviated job title';

次の文は、データベースからこのコメントを削除します。

COMMENT ON COLUMN employees.job_id IS '';