# odbc_statistics

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_statistics — Calcul des statistiques sur une table

### Description

odbc_statistics(
Odbc\Connection `$odbc`,
?string `$catalog`,
string `$schema`,
string `$table`,
int `$unique`,
int `$accuracy`
): Odbc\Result|false

Calcul des statistiques sur une table.

### Liste de paramètres

`odbc`

  L'objet 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

Renvoie un objet 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`.

### Historique

Version | Description
--- | ---
8.4.0 | `odbc` attend désormais une instance de Odbc\Connection; auparavant, un resource était attendu.
8.4.0 | Cette fonction retourne désormais une instance de Odbc\Result; auparavant, un resource était retourné.

### 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] =>
    )

### Voir aussi

- odbc_tables() - Liste les tables d'une source