Manuel PHP
Précédent |  | Suivant

# db2_statistics

(PECL)

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 colonne | Description
--- | ---
TABLE_CAT | Nom du catalogue que contient la table. La valeur est `NULL` si la table n'a pas de catalogue.
TABLE_SCHEM | Nom du schéma que contient la table.
TABLE_NAME | Nom 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 retour | Type de paramètre
0 (SQL_FALSE) | L'index autorise les valeurs dupliquées.
1 (SQL_TRUE) | Les valeurs index doivent être uniques.
`NULL` | La ligne contient des informations statistiques à propos de la table.

INDEX_QUALIFIER | Une 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_NAME | Une 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 retour | Type 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_POSITION | Un 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_NAME | Le 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_CONDITION | Retourne 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()

Précédent | Sommaire | Suivant
db2_special_columns | Niveau supérieur | db2_stmt_error