db2_statistics
(PECL ibm_db2 >= 1.0.0)
db2_statistics — Retourne un jeu de résultats listant les index et statistiques d'une table
Description
$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 ou FALSE
si une erreur survient.
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 :
|
||||||||||
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 :
|
||||||||||
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() - Retourne un jeu de résultats listant les colonnes et ses privilèges d'une table
- db2_columns() - Retourne un jeu de résultats listant les colonnes et ses métadonnées d'une table
- db2_foreign_keys() - Retourne un jeu de résultats listant les clés étrangères d'une table
- db2_primary_keys() - Retourne un jeu de résultats listant les clés d'une table
- db2_procedure_columns() - Retourne un jeu de résultats listant les paramètres de procédure d'enregistrement
- db2_procedures() - Retourne un jeu de résultats listant les procédures d'enregistrement enregistrées dans la base de données
- db2_special_columns() - Retourne un jeu de résultats listant les identifiants uniques des lignes d'une table
- db2_table_privileges() - Retourne un jeu de résultats listant les tables et leurs privilèges qui leur sont associées d'une base de données
- db2_tables() - Retourne la liste des tables et leurs métadonnées