(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
являются
пустыми строками, то результирующий набор будет содержать список допустимых
квалификаторов для источника данных (все столбцы, кроме столбца
TABLE_QUALIFIER, содержат NULL).
schema
равно символу процента (%),
а catalog
и table
являются
пустыми строками, то результирующий набор будет содержать список допустимых
владельцев для источника данных (все столбцы, кроме столбца TABLE_OWNER,
содержат NULL).
table_type
равно символу процента (%),
а catalog
, schema
и
table
являются пустыми строками, то результирующий
набор будет содержать список допустимых типов таблиц для источника данных.
(все столбцы, кроме столбца TABLE_TYPE, содержат NULL).
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_CAT
TABLE_SCHEM
TABLE_NAME
TABLE_TYPE
REMARKS
Результирующий набор упорядочивается по TABLE_TYPE
,
TABLE_CAT
, TABLE_SCHEM
и
TABLE_NAME
.
Версия | Описание |
---|---|
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] => )