Mit dieser Anweisung speichern Sie einen Kommentar für ein Datenbankobjekt in den Systemtabellen.

Syntax

COMMENT ON {
    COLUMN [ Eigentümer.]Tabellenname.Spaltenname
   | DBSPACE DBSpace-Name
   | EVENT [ Eigentümer.]Ereignisname
   | EXTERNAL ENVIRONMENT Umgebungsname
   | EXTERNAL OBJECT Objektname
   | FOREIGN KEY [ Eigentümer.]Tabellenname.Rollenname
   | INDEX [ [ Eigentümer.] Tabelle.]Indexname
   | INTEGRATED LOGIN Integrierte_Login-ID
   | JAVA CLASS Java-Klassenname
   | JAVA JAR Java-Jar-Name
   | KERBEROS LOGIN "Client-Kerberos-Principal"
   | LOGIN POLICY Richtlinienname
   | MATERIALIZED VIEW [ Eigentümer.]materialisierte_Ansicht_Name
   | PRIMARY KEY ON [ Eigentümer.]Tabellenname
| PROCEDURE  [ Eigentümer.]Prozedurname
   | SERVICE Webdienst_Name
   | TABLE [ Eigentümer.]Tabellenname
| TEXT CONFIGURATION  [ Eigentümer.]Textkonfigurationsname
   | TEXT INDEX Textindexname ON [ Eigentümer.]Tabellenname
   | TRIGGER [ [ Eigentümer.]Tabellenname.]Triggername
   | USER Benutzer_ID
   | VIEW [ Eigentümer.]Ansichtsname
}
IS Kommentar

Kommentar : Zeichenfolge | NULL

Umgebungsname : 
JAVA
| PERL
| PHP
| CLR
| C_ESQL32
| C_ESQL64
| C_ODBC32
| C_ODBC64

Bemerkungen

Mit der COMMENT-Anweisung können Sie eine Bemerkung (Kommentar) für ein Objekt in der Datenbank setzen. Die COMMENT-Anweisung aktualisiert Bemerkungen, die in der Systemtabelle ISYSREMARKS aufgelistet sind. Sie können einen Kommentar entfernen, indem Sie diesen auf NULL setzen. Um einen Index oder einen Trigger zu kommentieren, muss der Eigentümer des Kommentars Eigentümer der Tabelle sein, für die der Index oder der Trigger definiert ist.

Sie können keine Kommentare für lokale temporäre Tabellen hinzufügen.

Der Umgebungsname ist: JAVA, PERL, PHP, CLR, C_ESQL32, C_ESQL64, C_ODBC32 oder C_ODBC64.

Wenn Sie den Assistenten zum Erstellen der Datenbankdokumentation zur Dokumentation Ihrer SQL Anywhere-Datenbank verwenden, haben Sie die Option, die Kommentare für Prozeduren, Funktionen, Trigger, Ereignisse und Ansichten in die Dokumentation aufzunehmen. Weitere Hinweise finden Sie unter Datenbank dokumentieren.

Berechtigungen

Sie müssen entweder Eigentümer des kommentierten Datenbankobjektes sein oder DBA-Berechtigung besitzen.

Nebenwirkungen

Automatisches Festschreiben (Autocommit).

Standards und Kompatibilität

Beispiel

Die folgenden Beispiele zeigen, wie Sie einen Kommentar hinzufügen und entfernen können:

Ein Kommentar wird zur Tabelle Employees hinzugefügt.

COMMENT
ON TABLE Employees
IS 'Employee information';

Ein Kommentar wird aus der Tabelle Employees entfernt.

COMMENT
ON TABLE Employees
IS NULL;

Um den für ein Objekt festgelegten Kommentar anzuzeigen, verwenden Sie eine SELECT-Anweisung wie im folgenden Beispiel. Hier wird der Kommentar für die ViewSalesOrders-Ansicht in der SQL Anywhere-Beispieldatenbank abgerufen.

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