Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
在系统表中存储关于数据库对象的注释。
COMMENT ON { COLUMN [ owner.]table-name.column-name | CERTIFICATE certificate-name | DBSPACE dbspace-name | EVENT [ owner.]event-name | EXTERNAL ENVIRONMENT environment-name | EXTERNAL [ ENVIRONMENT ] OBJECT object-name | FOREIGN KEY [ owner.]table-name.key-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" | LDAP SERVER ldapua-server-name | LOGIN POLICY policy-name | MATERIALIZED VIEW [ owner.]materialized-view-name | MIRROR SERVER mirror-server-name | PRIMARY KEY ON [ owner.]table-name | PROCEDURE [ owner.]procedure-name | PUBLICATION [ owner.] publication-name | REMOTE MESSAGE TYPE remote-message-type-name | ROLE role-name | SEQUENCE sequence-name | SERVICE web-service-name | SPATIAL REFERENCE SYSTEM srs-name | SPATIAL UNIT OF MEASURE uom-identifier | SYNCHRONIZATION PROFILE synchronization-profile-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 语句可更新系统表 ISYSREMARK 中所列出的注释。通过将注释设置成 NULL 可以删除注释。对于索引或触发器的注释,其所有者是定义该索引或触发器的表的所有者。
不能为本地临时表添加注释。
如果使用 [数据库文档向导] 生成 SQL Anywhere 数据库文档,则可以选择在输出中包括对过程、函数、触发器、事件和视图的注释。
如果具有 COMMENT ANY OBJECT 系统特权,则可对使用 CREATE ANY OBJECT 系统特权创建的任何内容进行注释。如果没有 COMMENT ANY OBJECT 系统特权,则必须符合如下所述要求:
对于数据库对象,必须至少满足以下其中一项条件:
您拥有该对象
您能够创建或更改由其他用户拥有的相同类型的对象(例如 CREATE ANY TABLE 或 ALTER ANY OBJECT)
您能够管理该类型的对象(例如 MANAGE ANY USER)
对于系统角色,您必须对该角色具有管理特权。
对于用户定义的角色,您必须拥有 MANAGE ROLES 系统特权,或者对该角色具有管理特权。
对于 Kerberos 或集成登录,您必须拥有 MANAGE ANY USER 系统特权。
对于 Java 类或 jar,您必须拥有 MANAGE ANY EXTERNAL OBJECT 系统特权。
自动提交。
SQL/2008 服务商扩充。
Transact-SQL 不受 Adaptive Server Enterprise 支持。
下面的示例显示如何添加和删除注释。
向 Employees 表添加注释。
COMMENT ON TABLE GROUPO.Employees IS 'Employee information';
从 Employees 表中删除注释。
COMMENT ON TABLE GROUPO.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';