Bonjour,

La plupart des bases de données actuelles acceptent des commandes spécifiques 
pour intégrer des commentaires, mais il n'y a pas de standard en la matière.

La commande la plus répandue (Oracle, DB2, PostgreSQL) est :
COMMENT ON <objet> IS 'commentaire';
Exemple :
COMMENT ON TABLE toto IS 'Ma table bien commentée';
COMMENT ON COLUMN toto.colonne1 IS 'Un commentaire ici';
COMMENT ON COLUMN toto.colonne2 IS 'Un autre commentaire';

Avec MySql, les commentaires peuvent être directement intégrés au LDD :
CREATE TABLE `toto` (
  `colonne1`   varchar(80)   default ''   COMMENT 'Un commentaire ici',
  `colonne2`   int(11)       default NULL COMMENT 'Un autre commentaire ici', 
  `colonne3`   double      default NULL COMMENT 'Encore un commentaire',
  `date`          date          default NULL COMMENT 'Le dernier commentaire'
)  COMMENT 'Ma table bien commentée';

Avec SQL SERVER, de mémoire, il faut passer par les propriétés étendues 
(extended properties), mais je n'en sais pas plus.

Cela dit, la solution de Jean-Marc a le grand mérite d'être portable sur 
n'importe quel SGBD.

PSOU

Le mercredi 16 décembre 2009 02:08:52, Alain Vaugham a écrit :
> Bonsoir la liste,
> 
> Quand j'ajoute des commentaires dans la description d'une table, ceux-ci ne
> sont pas pris en compte.
> 
> 
> Les colonnes de ma table bien documentés :
> CREATE TABLE `toto` (
>   `colonne1`       varchar(80)   default '',        # Un commentaire ici
>   `colonne2`       int(11)       default NULL,      # Un autre commentaire
>  ici `colonne3`       double        default NULL,      # Encore un
>  commentaire `date`           date          default NULL       # Le dernier
>  commentaire ) ;
> 
> 
> Ce qui est pris en compte :
> desc toto;
> +----------+-------------+------+-----+---------+-------+
> 
> | Field    | Type        | Null | Key | Default | Extra |
> 
> +----------+-------------+------+-----+---------+-------+
> 
> | colonne1 | varchar(80) | YES  |     |         |       |
> | colonne2 | int(11)     | YES  |     | NULL    |       |
> | colonne3 | double      | YES  |     | NULL    |       |
> | date     | date        | YES  |     | NULL    |       |
> 
> +----------+-------------+------+-----+---------+-------+
> 
> 
> Le résultat dans un dump :
> CREATE TABLE `toto` (
>   `colonne1` varchar(80) default '',
>   `colonne2` int(11) default NULL,
>   `colonne3` double default NULL,
>   `date` date default NULL
> ) ;
> 
> 
> Comment font les "pros" des bases de données pour bien documenter leur
>  tables?
> 
> Merci par avance.
> 

_________________________________
Linux mailing list
[email protected]
http://lists.parinux.org/mailman/listinfo/linux

Répondre à