db2_statistics

(no version information, might be only in CVS)

db2_statistics --  Retourne un jeu de résultats listant les index et statistiques d'une table

Description

resource db2_statistics ( resource connection, string qualifier, string schema, string table-name, bool unique )

Retourne un jeu de résultats listant les index et statistiques d'une table.

Liste de paramètres

connection

Une connexion valide à une base de données IBM DB2, Cloudscape ou Apache Derby.

qualifier

Un qualificatif pour les bases de données DB2 qui fonctionnent sur les serveurs OS/390 ou z/OS. Pour les autres bases de données, passez NULL ou une chaîne vide.

schema

Le schéma qui contient les tables visées. Si le paramètre est NULL, les statistiques et les index sont retournés pour le schéma de l'utilisateur en cours.

table_name

Le nom de la table.

unique

Un entier représentant le type d'information à retourner.

0

Retourne seulement les informations pour les index uniques de la table.

1

Retourne les informations pour tous les index de la table.

Valeurs de retour

Ce que la fonction retourne, premièrement lors de succès, ensuite lors d'échec. Voyez aussi l'entité Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Nom de la colonneDescription
TABLE_CATNom du catalogue que contient la table. La valeur est NULL si la table n'a pas de catalogue.
TABLE_SCHEMNom du schéma que contient la table.
TABLE_NAMENom de la table.
NON_UNIQUE

Un entier représentant si l'index interdit les valeurs uniques ou si la ligne représente des statistiques sur la table elle-même :

Valeur de retourType de paramètre
0 (SQL_FALSE)L'index autorise les valeurs dupliquées.
1 (SQL_TRUE)Les valeurs index doivent être uniques.
NULLLa ligne contient des informations statistiques à propos de la table.

INDEX_QUALIFIERUne chaîne de caractères représentant un qualificatif qui devrait avoir été préalablement fixé à INDEX_NAME pour qualifier complètement l'index.
INDEX_NAMEUne chaîne représentant le nom de l'index.
TYPE

Un entier représentant le type d'informations contenues dans cette ligne du jeu de résultats :

Valeur de retourType de paramètre
0 (SQL_TABLE_STAT)La ligne contient des informations statistiques à propos de la table.
1 (SQL_INDEX_CLUSTERED)La ligne contient des informations à propos d'index groupé.
2 (SQL_INDEX_HASH)La ligne contient des informations à propos d'index haché.
3 (SQL_INDEX_OTHER)La ligne contient des informations à propos du type d'index qui n'est pas groupé ni haché.

ORDINAL_POSITIONUn tableau commençant à l'index 1 indiquant la colonne dans l'index. NULL si la ligne contient des informations statistiques à propos de la table.
COLUMN_NAMELe nom de la colonne dans l'index. NULL si la ligne contient des informations statistiques à propos de la table.
ASC_OR_DESC A si la colonne est triée en ordre alphabétique, D si la colonne est triée en ordre alphabétique inverse, NULL si la ligne contient des informations statistiques à propos de la table.
CARDINALITY

Si la ligne contient des informations à propos d'un index, cette colonne contiendra un entier représentant le nombre de valeurs uniques dans l'index.

Si la ligne contient des informations à propos de la table, cette colonne contiendra un entier représentant le nombre de lignes dans la table.

PAGES

Si la ligne contient des informations à propos d'un index, cette colonne contiendra un entier représentant le nombre de pages utilisées pour enregistrer l'index.

Si la ligne contient des informations à propos de la table, cette colonne contiendra un entier représentant le nombre de pages utilisées pour enregistrer la table.

FILTER_CONDITIONRetourne toujours NULL.

Voir aussi

db2_column_privileges()
db2_columns()
db2_foreign_keys()
db2_primary_keys()
db2_procedure_columns()
db2_procedures()
db2_special_columns()
db2_table_privileges()
db2_tables()

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:03