COMMENT ON

CHARACTER SETResponsables du traitement des données(DML)

`COMMENT ON`

Destination

Documentation des métadonnées.

Disponible en

DSQL, ESQL

Syntaxe

COMMENT ON <object> IS {'sometext' | NULL}
<object> ::=
    { DATABASE | SCHEMA }
  | <basic-type> objectname
  | USER username [USING PLUGIN plugin_name]
  | COLUMN relationname.fieldname
  | [PROCEDURE | FUNCTION] PARAMETER
    [package_name.] routinename.paramname
  | {PROCEDURE | [EXTERNAL] FUNCTION}
    routinename
  | [GLOBAL] MAPPING mappingname

<basic-type> ::=
    CHARACTER SET
  | COLLATION
  | DOMAIN
  | EXCEPTION
  | FILTER
  | GENERATOR
  | INDEX
  | PACKAGE
  | ROLE
  | SEQUENCE
  | TABLE
  | TRIGGER
  | VIEW

Table 1. Paramètres de l’opérateur `COMMENT ON`
Paramètre	Description
sometext	Texte du commentaire.
basic-type	Le type d’objet de métadonnées.
objectname	Le nom de l’objet de métadonnées.
relationname	Le nom d’une table ou d’une vue.
filedname	Le nom du champ d’une table ou d’une vue.
routinename	Le nom de la procédure ou de la fonction stockée.
paramname	Le nom du paramètre de la procédure ou de la fonction stockée.
package_name	Nom du paquet.
username	Nom d’utilisateur.
plugin_name	Le nom du plug-in de gestion des utilisateurs.
mappingname	Mapping Name.

L’instruction COMMENT ON ajoute des commentaires aux objets de la base de données (métadonnées). Les commentaires sont enregistrés dans les champs de texte RDB$DESCRIPTION du type BLOB de la table système correspondante (à partir de ces champs, l’application client peut visualiser les commentaires).

Lorsque vous ajoutez un commentaire pour un utilisateur, vous pouvez spécifier dans quel plugin de gestion d’utilisateur il se trouve en utilisant la phrase optionnelle USING PLUGIN. Si cette phrase est manquante, on suppose que l’utilisateur est créé dans le plugin de gestion par défaut, c’est-à-dire le premier plugin spécifié dans le paramètre UserManager du fichier firebird.conf ou databases.conf.

Note	Si vous entrez un commentaire vide (''), il sera stocké dans la base de données comme `NULL`.

Qui peut ajouter un commentaire ?

L’instruction COMMENT ON peut être exécutée :

Administrateurs.
Le propriétaire de l’objet pour lequel le commentaire est ajouté ;
Utilisateurs avec le privilège ALTER ANY <object_type>.