odbc_statistics
(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_statistics — Calcul des statistiques sur une table
Description
odbc_statistics(
resource $odbc
,
?string $catalog
,
string $schema
,
string $table
,
int $unique
,
int $accuracy
): resource|false
Liste de paramètres
-
odbc
-
L'identifiant de connexion ODBC,
voir la documentation de la fonction odbc_connect() pour plus
de détails.
-
catalog
-
Le catalogue ('calificatif' dans le jargon ODBC 2).
-
schema
-
Le schéma ('propriétaire' dans le jargon ODBC 2).
-
table
-
Le nom de la table.
-
unique
-
Le type de l'index.
Un de SQL_INDEX_UNIQUE
ou SQL_INDEX_ALL
.
-
accuracy
-
Un de SQL_ENSURE
ou SQL_QUICK
.
Ce dernier demande au pilote de récupérer la CARDINALITY
et PAGES
seulement s'ils sont immédiatement disponible
depuis le serveur.
Valeurs de retour
Retourne un identifiant de résultat ODBC ou false
si une erreur survient.
Le jeu de résultat contient les colonnes suivantes :
TABLE_CAT
TABLE_SCHEM
TABLE_NAME
NON_UNIQUE
INDEX_QUALIFIER
INDEX_NAME
TYPE
ORDINAL_POSITION
COLUMN_NAME
ASC_OR_DESC
CARDINALITY
PAGES
FILTER_CONDITION
Les pilotes peuvent signaler des colonnes supplémentaires.
Le jeu de résultat est ordonné par NON_UNIQUE
, TYPE
, INDEX_QUALIFIER
,
INDEX_NAME
et ORDINAL_POSITION
.
Exemples
Exemple #1 Liste les Statistiques d'une Table
<?php
$conn = odbc_connect($dsn, $user, $pass);
$statistics = odbc_statistics($conn, 'TutorialDB', 'dbo', 'TEST', SQL_INDEX_UNIQUE, SQL_QUICK);
while (($row = odbc_fetch_array($statistics))) {
print_r($row);
break; // further rows omitted for brevity
}
?>
Résultat de l'exemple ci-dessus est similaire à :
Array
(
[TABLE_CAT] => TutorialDB
[TABLE_SCHEM] => dbo
[TABLE_NAME] => TEST
[NON_UNIQUE] =>
[INDEX_QUALIFIER] =>
[INDEX_NAME] =>
[TYPE] => 0
[ORDINAL_POSITION] =>
[COLUMN_NAME] =>
[ASC_OR_DESC] =>
[CARDINALITY] => 15
[PAGES] => 3
[FILTER_CONDITION] =>
)