説明
このステートメントは、データディクショナリにテーブルまたはテーブル列、ビューまたはビュー列に関するコメントを追加します。
権限要件
COMMENT ステートメントを実行するには、現在のユーザーが COMMENT ANY TABLE 権限を持っている必要があります。OceanBaseデータベースの権限の詳細については、Oracleモードの権限分類を参照してください。
構文
-- テーブルまたはビューにコメントを追加
COMMENT ON TABLE
[schema.]{table_name | view_name} IS 'string';
-- テーブルまたはビューの列にコメントを追加
COMMENT ON COLUMN
[schema.]{table_name. | view_name.}column_name IS 'string';
説明
- ビュー
ALL_TAB_COMMENTS、DBA_TAB_COMMENTSまたはUSER_TAB_COMMENTSを使用して、テーブルとビューのコメントを照会できます。 - ビュー
ALL_COL_COMMENTS、DBA_COL_COMMENTSまたはUSER_COL_COMMENTSを使用して、テーブルとビューのすべての列のコメントを照会できます。 - コメント文字列の最大長は4000文字です。これを超えるとエラーが発生します。
- 中国語、英語、特殊文字（例：
@#$%^&*()_+-=[]{}|;:'",.<>/?など）をサポートしています。 - 空文字列
''を使用してコメントを削除できます。
パラメータの説明
パラメータ |
説明 |
|---|---|
| schema | スキーマを指定します。schema. を省略した場合、OceanBaseデータベースは、コメントを追加する対象であるテーブルなどが現在のスキーマにあると仮定します。 |
| table_name | テーブル名を指定します。 |
| view_name | ビュー名を指定します。 |
| column_name | 列名を指定します。 |
| string | コメントのテキストを指定します。string を空文字列（''）に設定すると、データベースからコメントが削除されます。 |
例
テーブル
employeesにコメントを追加します。--テーブル employees が存在することを前提とします obclient> COMMENT ON TABLE employees IS 'Comment of the employees';テーブル
employeesのemp_name列にコメントを追加します。--テーブル employees と列 emp_name が存在することを前提とします obclient> COMMENT ON COLUMN employees.emp_name IS 'Name of person in table employees';データベースからテーブル
employeesのemp_name列のコメントを削除します。--テーブル employees と列 emp_name が存在することを前提とします obclient> COMMENT ON COLUMN employees.emp_name IS '';ビュー
view1にコメントを追加します。--ビュー view1 が存在することを前提とします obclient> COMMENT ON TABLE view1 IS 'Comment of the view1';ビュー
view1のname列にコメントを追加します。--ビュー view1 と列 name が存在することを前提とします obclient> COMMENT ON COLUMN view1.name IS 'Name of person in view view1';データベースからビュー
view1のname列のコメントを削除します。--ビュー view1 と列 name が存在することを前提とします obclient> COMMENT ON COLUMN view1.name IS '';