此语句用于在系统表中存储关于数据库对象的注释。

语法

COMMENT ON {
    COLUMN [ owner.]table-name.column-name
   | DBSPACE dbspace-name
   | EVENT [ owner.]event-name
   | EXTERNAL ENVIRONMENT environment-name
   | EXTERNAL OBJECT object-name
   | FOREIGN KEY [ owner.]table-name.role-name
   | INDEX [ [ owner.] table.]index-name
   | INTEGRATED LOGIN integrated-login-id
   | JAVA CLASS java-class-name
   | JAVA JAR java-jar-name
   | KERBEROS LOGIN "client-Kerberos-principal"
   | LOGIN POLICY policy-name
   | MATERIALIZED VIEW [ owner.]materialized-view-name
   | PRIMARY KEY ON [ owner.]table-name
   | PROCEDURE [ owner.]procedure-name
   | SERVICE web-service-name
   | TABLE [ owner.]table-name
   | TEXT CONFIGURATION [ owner.]text-config-name
   | TEXT INDEX text-index-name ON [ owner.]table-name
   | TRIGGER [ [ owner.]tablename.]trigger-name
   | USER userid
   | VIEW [ owner.]view-name
}
IS comment

comment : string | NULL

environment-name : 
JAVA
| PERL
| PHP
| CLR
| C_ESQL32
| C_ESQL64
| C_ODBC32
| C_ODBC64

注释

COMMENT 语句可用于在数据库中为对象设置注释。COMMENT 语句可更新系统表 ISYSREMARKS 中所列出的注释。通过将注释设置成 NULL 可以删除注释。对于索引或触发器的注释，其所有者是定义该索引或触发器的表的所有者。

不能为本地临时表添加注释。

environment-name 为 JAVA、PERL、PHP、CLR、C_ESQL32、C_ESQL64、C_ODBC32 或 C_ODBC64 中之一。

如果使用 [数据库文档生成器] 生成 SQL Anywhere 数据库文档，则可以选择在输出中包括对过程、函数、触发器、事件和视图的注释。请参见记录数据库。

权限

必须是要注释的数据库对象的所有者，或者必须有 DBA 权限。

副作用

自动提交。

标准和兼容性

示例

下面的示例显示如何添加和删除注释。

向 Employees 表添加注释。

COMMENT
ON TABLE Employees
IS 'Employee information';

从 Employees 表中删除注释。

COMMENT
ON TABLE Employees
IS NULL;

要查看对象的注释集，可使用与以下类似的 SELECT 语句。此示例检索 SQL Anywhere 示例数据库中 ViewSalesOrders 视图的注释集。

SELECT remarks 
FROM SYSTAB t, SYSREMARK r 
WHERE t.object_id = r.object_id 
AND t.table_name = 'ViewSalesOrders';