Получает статистику о таблице

# odbc_statistics

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

odbc_statistics — Получает статистику о таблице

### Описание

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

Функция получает статистику о таблице и её индексах.

### Список параметров

`odbc`
  Объект ODBC-соединения. Подробнее о коннекторе рассказывает описание функции odbc_connect().
`catalog`

  Каталог ('qualifier' на языке ODBC 2).

`schema`

  Схема ('owner' на языке ODBC 2).

`table`

  Имя таблицы.

`unique`

  Тип индекса. Константа `SQL_INDEX_UNIQUE` или `SQL_INDEX_ALL`.

`accuracy`

  Константа `SQL_ENSURE` или `SQL_QUICK`. Последняя запрашивает у драйвера получение `CARDINALITY` и `PAGES`, только если они легко доступны с сервера.

### Возвращаемые значения

Функция возвращает объект ODBC с результатом или `false`, если возникла ошибка.

Набор результатов содержит следующие столбцы:

- `TABLE_CAT`
- `TABLE_SCHEM`
- `TABLE_NAME`
- `NON_UNIQUE`
- `INDEX_QUALIFIER`
- `INDEX_NAME`
- `TYPE`
- `ORDINAL_POSITION`
- `COLUMN_NAME`
- `ASC_OR_DESC`
- `CARDINALITY`
- `PAGES`
- `FILTER_CONDITION`

Драйвер иногда сообщает о дополнительных столбцах.

Набор результатов упорядочивается по столбцам `NON_UNIQUE`, `TYPE`, `INDEX_QUALIFIER`, `INDEX_NAME` и `ORDINAL_POSITION`.

### Список изменений

Версия | Описание
--- | ---
8.4.0 | Параметр `odbc` теперь принимает объект соединения Odbc\Connection; раньше принимался тип resource.
8.4.0 | Функция теперь возвращает объект с результатом ODBC-запроса Odbc\Result; раньше возвращалось значение с типом resource.

### Примеры

Пример #1 Пример вывода статистики о таблице

    <?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; // Следующие строки опустили для краткости
    }

    ?>

Вывод приведённого примера будет похож на:

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

### Смотрите также

- odbc_tables() - Получает список имён таблиц, которые хранятся в источнике данных

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open