COMMENTS

CHARACTER SETResponsables du traitement des données(DML)

Les objets de la base de données et la base de données elle-même peuvent contenir des annotations, ce qui constitue un outil de documentation pratique pendant le développement et la maintenance de la base de données.

`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`.