Manuel de référence MySQL 5.0

Un schéma est une base de données. La table SCHEMATA fournit des informations sur les bases de données.

Notes :

• pour SQL_PATH, nous aurons peut-être quelque chose de fonctionnelle en MySQL 5.x. Pour le moment, il vaut toujours NULL.

Les commandes suivantes sont équivalentes :

SELECT SCHEMA_NAME AS `Database`
  FROM INFORMATION_SCHEMA.SCHEMATA
  [WHERE SCHEMA_NAME LIKE 'wild']

SHOW DATABASES
  [LIKE 'wild']

La table TABLES fournit des informations sur les bases de données.

Notes :

• TABLE_SCHEMA et TABLE_NAME sont un seul champ dans le résultat de SHOW, par exemple Table_in_db1 ;
• TABLE_TYPE doit être BASE TABLE ou VIEW. Si la table est temporaire, alors TABLE_TYPE = TEMPORARY. Il n'y a pas de vues temporaires, alors il ne peut pas y avoir d'ambiguïté ;
• nous n'avons rien pour les jeux de caractères par défaut des tables. TABLE_COLLATION s'en approche, car les noms des collations commencent avec un nom de jeu de caractères.

Les commandes suivantes sont équivalentes :

SELECT table_name FROM INFORMATION_SCHEMA.TABLES
  [WHERE table_schema = 'db_name']
  [WHERE|AND table_name LIKE 'wild']

SHOW TABLES
  [FROM db_name]
  [LIKE 'wild']

La table COLUMNS fournit des informations sur les colonnes dans les tables.

Notes :

• dans SHOW, la colonne Type inclut les valeurs de différentes colonnes COLUMNS ;
• ORDINAL_POSITION est obligatoire, car il faudra peut-être un jour indiquer ORDER BY ORDINAL_POSITION. Contrairement à SHOW, SELECT n'a pas de classement par défaut ;
• CHARACTER_OCTET_LENGTH doit être le même que CHARACTER_MAXIMUM_LENGTH, sauf pour les jeux de caractères multi-octets ;
• CHARACTER_SET_NAME peut être dérivé de Collation. Par exemple, si vous indiquez SHOW FULL COLUMNS FROM t, et que vous pouvez voir dans la colonne Collation la valeur latin1_swedish_ci, alors le jeu de caractères est la partie placée avant le premier caractère souligné : latin1.

Les commandes suivantes sont presque équivalentes :

SELECT COLUMN_NAME, DATA_TYPE, IS_NULLABLE, COLUMN_DEFAULT
  FROM INFORMATION_SCHEMA.COLUMNS
  WHERE table_name = 'tbl_name'
  [AND table_schema = 'db_name']
  [AND column_name LIKE 'wild']

SHOW COLUMNS
  FROM tbl_name
  [FROM db_name]
  [LIKE wild]

La table STATISTICS fournit des informations sur les tables d'index.

Notes :

• il n'y a pas de table standard pour les index. La liste précédente est similaire au résultat que retourne SQL Server 2000 pour sp_statistics, mais nous avons remplacé le nom QUALIFIER par CATALOG et nous avons remplacé le nom OWNER par SCHEMA.
  En fait, la table précédente et le résultat de SHOW INDEX sont dérivés du même parent. La corrélation est très bonne.

Les commandes suivantes sont équivalentes :

SELECT * FROM INFORMATION_SCHEMA.STATISTICS
  WHERE table_name = 'tbl_name'
  [AND schema_name = 'db_name'

SHOW INDEX
  FROM tbl_name
  [FROM db_name]

La table USER_PRIVILEGES fournit les informations sur les droits globaux. Cette information provient des tables mysql.user.

Notes :

• c'est une table non standard. Elle prend ses valeurs dans les tables mysql.user.

La table SCHEMA_PRIVILEGES fournit des informations sur les droits des schémas (l'autre nom des bases de données). Ces informations proviennent de la table mysql.db.

Notes :

• ceci est une table non standard. Elle prend ses valeurs dans la table mysql.db.

La table TABLE_PRIVILEGES affiche les informations sur les droits des tables. Ces informations proviennent de mysql.tables_priv.

Les requêtes suivantes ne sont pas équivalentes :

SELECT ... FROM INFORMATION_SCHEMA.TABLE_PRIVILEGES

SHOW GRANTS ...

PRIVILEGE_TYPE peut contenir l'une des valeurs suivantes : SELECT, INSERT, UPDATE, REFERENCES, ALTER, INDEX, DROP et CREATE VIEW.

La table COLUMN_PRIVILEGES fournit les informations sur les droits reliés aux colonnes. Ces informations proviennent de la table de droits mysql.columns_priv.

Notes :

• dans le résultat de SHOW FULL COLUMNS, les droits sont toujours affichés dans un champ, en minuscules, comme select, insert, update, references. Dans COLUMN_PRIVILEGES, il y a une ligne par droit, et la valeur est en majuscules ;
• PRIVILEGE_TYPE peut contenir une et une seule de ces valeurs : SELECT, INSERT, UPDATE, REFERENCES ;
• si l'utilisateur a le droit de GRANT OPTION, le droit IS_GRANTABLE doit valoir YES. Sinon, IS_GRANTABLE doit valoir NO. Le résultat ne présente pas GRANT OPTION comme un droit séparé.

Les commandes suivantes ne sont pas équivalentes :

SELECT ... FROM INFORMATION_SCHEMA.COLUMN_PRIVILEGES

SHOW GRANTS ...

La table CHARACTER_SETS fournit des informations sur les jeux de caractères disponibles.

Notes :

• nous avons ajouté deux colonnes non standards que sont Description et Maxlen, dans la commande SHOW CHARACTER SET.

Les commandes suivantes sont équivalentes :

SELECT * FROM INFORMATION_SCHEMA.CHARACTER_SETS
  [WHERE name LIKE 'wild']

SHOW CHARACTER SET
  [LIKE 'wild']

La table COLLATIONS fournit des informations sur les collations de chaque jeu de caractères.

Notes :

• nous avons ajouté cinq colonnes non standards qui correspondent au Charset, Id, Default, Compiled et Sortlen dans le résultat de SHOW COLLATION.

Les commandes suivantes sont équivalentes :

SELECT COLLATION_NAME FROM INFORMATION_SCHEMA.COLLATIONS
  [WHERE collation_name LIKE 'wild']

SHOW COLLATION
  [LIKE 'wild']

La table COLLATION_CHARACTER_SET_APPLICABILITY indique les jeux de caractères et les collations associées. Les colonnes sont équivalentes aux deux premières colonnes du résultat de la commande SHOW COLLATION.

La table TABLE_CONSTRAINTS décrit les tables qui ont des contraintes.

Notes :

• la valeur CONSTRAINT_TYPE peut être UNIQUE, PRIMARY KEY ou FOREIGN KEY ;
• les informations de UNIQUE et PRIMARY KEY sont les mêmes que celles que vous obtenez dans le champ Key_name du résultat de SHOW INDEX où le champ Non_unique vaut 0 ;
• la colonne CONSTRAINT_TYPE peut contenir l'une de ces valeurs : UNIQUE, PRIMARY KEY, FOREIGN KEY, CHECK. C'est une colonne de type CHAR et non pas ENUM. La valeur de CHECK n'est pas valable jusqu'à ce que nous supportions CHECK.

La table KEY_COLUMN_USAGE décrit les contraintes sur les colonnes.

Notes :

• si la contrainte est une clé étrangère, alors c'est la colonne de la clé étrangère, et non pas la colonne que la clé étrangère référence ;
• la valeur de ORDINAL_POSITION est la position de la colonne dans la contrainte, et non pas la position de la colonne dans la table. Les positions des colonnes commencent à 1 ;
• la valeur de POSITION_IN_UNIQUE_CONSTRAINT est NULL pour les contraintes uniques et les clés primaires. Pour les contraintes de clé étrangère, c'est la position ordinale dans la clé de la table qui est référencée.
  Par exemple, supposez que vous ayez les deux tables t1 et t3, avec les définitions suivantes :

CREATE TABLE t1
(
    s1 INT,
    s2 INT,
    s3 INT,
    PRIMARY KEY(s3)
) ENGINE=InnoDB;

CREATE TABLE t3
(
    s1 INT,
    s2 INT,
    s3 INT,
    KEY(s1),
    CONSTRAINT CO FOREIGN KEY (s2) REFERENCES t1(s3)
) ENGINE=InnoDB;

Pour ces deux tables, la table KEY_COLUMN_USAGE a deux lignes :

• une ligne avec CONSTRAINT_NAME='PRIMARY', TABLE_NAME='t1', COLUMN_NAME='s3', ORDINAL_POSITION=1, POSITION_IN_UNIQUE_CONSTRAINT=NULL ;
• une ligne avec CONSTRAINT_NAME='CO', TABLE_NAME='t3', COLUMN_NAME='s2', ORDINAL_POSITION=1, POSITION_IN_UNIQUE_CONSTRAINT=1.

La table ROUTINES fournit des informations sur les procédures stockées (sur les procédures et les fonctions). La table ROUTINES n'inclut pas les fonctions utilisateurs (dites UDF) actuellement.

La colonne appelée « mysql.proc name » indique la colonne de la table mysql.proc qui correspond à la colonne de la table INFORMATION_SCHEMA.ROUTINES, si elle existe.

Notes :

• MySQL calcule EXTERNAL_LANGUAGE comme suit :

  • si mysql.proc.language='SQL', alors EXTERNAL_LANGUAGE vaut NULL ;
  • sinon, EXTERNAL_LANGUAGE prend la valeur de mysql.proc.language. Cependant, nous n'avons pas de langage externe pour le moment, ce qui fait que cette valeur est toujours NULL.

La table VIEWS fournit des informations sur les vues dans les bases.

Notes :

• il existe un nouveau droit, SHOW VIEW, sans lequel vous ne pourrez pas voir la table VIEWS ;

• la colonne VIEW_DEFINITION contient l'essentiel de ce que vous voyez dans le champ Create Table que la commande SHOW CREATE VIEW produit. Omettez les mots avant SELECT et omettez les mots après WITH CHECK OPTION. Par exemple, si la commande initiale était :

   

  Sélectionnez

  CREATE VIEW v AS
    SELECT s2,s1 FROM t
    WHERE s1 > 5
    ORDER BY s1
    WITH CHECK OPTION;

  alors la définition de la vue serait:

   

  Sélectionnez

  SELECT s2,s1 FROM t WHERE s1 > 5 ORDER BY s1

• la colonne CHECK_OPTION contient toujours la valeur NONE ;

• la colonne IS_UPDATABLE vaut YES si la vue est modifiable, et NO dans le cas contraire.

Nous allons ajouter d'autres tables dans la base INFORMATION_SCHEMA prochainement. Notamment, nous avons identifié le besoin de tables telles que INFORMATION_SCHEMA.PARAMETERS, INFORMATION_SCHEMA.REFERENTIAL_CONSTRAINTS et INFORMATION_SCHEMA.TRIGGERS.