(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_tables — Получает список имён таблиц, которые хранятся в источнике данных
$odbc,$catalog = null,$schema = null,$table = null,$types = nullФункция перечисляет таблицы в запрошенном диапазоне.
Для поддержки перечисления квалификаторов, владельцев и типов таблиц доступна
следующая специальная семантика для параметром catalog,
schema, table
и table_type:
catalog равно символу процента (%),
а в аргументах schema и table передали
пустые строки.
schema равно символу процента (%),
а в аргументы catalog и table передали
пустые строки.
table_type равно символу процента (%),
а в аргументах catalog, schema
и table передали пустые строки.
odbcОбъект ODBC-соединения. Подробнее о коннекторе рассказывает описание функции odbc_connect().
catalogКаталог ('qualifier' на языке ODBC 2).
schema
Схема ('owner' на языке ODBC 2).
Параметр принимает следующие шаблоны поиска:
%, который соответствует нулю или более символам,
и _, который соответствует ровно одному символу.
table
Имя таблицы.
Параметр принимает следующие шаблоны поиска:
%, который соответствует нулю или более символам,
и _, который соответствует ровно одному символу.
types
В параметр передают список значений типов через запятую,
если в параметр table_type передаётся не пустая строка;
каждое значение разрешается заключать в одинарные
кавычки ' или передавать значения без кавычек. Например,
'TABLE','VIEW' или TABLE, VIEW.
Функция odbc_tables() не вернёт никаких результатов для типа,
если источник данных не поддерживает заданный тип таблицы.
Функция возвращает объект ODBC с результатом, который содержит информацию,
или false, если возникла ошибка.
Набор результатов содержит следующие столбцы:
TABLE_CATTABLE_SCHEMTABLE_NAMETABLE_TYPEREMARKS
Набор результатов упорядочивается по столбцам TABLE_TYPE,
TABLE_CAT, TABLE_SCHEM
и TABLE_NAME.
| Версия | Описание |
|---|---|
| 8.4.0 |
Параметр odbc теперь ожидает экземпляр соединения Odbc\Connection;
раньше ожидался аргумент с типом resource.
|
| 8.4.0 | Функция теперь возвращает объект с результатом ODBC-запроса Odbc\Result; раньше возвращалось значение с типом resource. |
| 8.0.0 |
Параметры schema, table
и types теперь принимают значение null.
|
Пример #1 Пример вывода списка таблиц в каталоге
<?php
$conn = odbc_connect($dsn, $user, $pass);
$tables = odbc_tables($conn, 'SalesOrders', 'dbo', '%', 'TABLE');
while (($row = odbc_fetch_array($tables))) {
print_r($row);
break; // Следующие строки опустили для краткости
}
?>Вывод приведённого примера будет похож на:
Array
(
[TABLE_CAT] => SalesOrders
[TABLE_SCHEM] => dbo
[TABLE_NAME] => Orders
[TABLE_TYPE] => TABLE
[REMARKS] =>
)