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 システムテーブル内の remarks カラムが更新されます。コメントは、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';