odbc_tables
(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_tables — Lista las tablas de una fuente
Descripción
Para soportar las enumeraciones de calificadores
propietarios y tipos de tabla, la siguiente
semántica para los parámetros
catalog, schema,
table y
table_type está disponible:
-
Si
catalog es un signo de porcentaje (%), y
schema y table son
strings vacíos, entonces el resultado contiene la lista de
calificadores válidos para la fuente (todas las columnas excepto
TABLE_QUALIFIER contienen NULL).
-
Si
schema es un signo de porcentaje (%), y
catalog y table
son strings vacíos, entonces el resultado contiene la lista de
propietarios de la fuente (todas las columnas excepto
TABLE_OWNER contienen NULL).
-
Si
table_type es un signo de porcentaje (%), y
catalog, schema y
table son strings vacíos, entonces el resultado
contiene la lista de tipos de tablas de la fuente (todas las columnas excepto
TABLE_TYPE contienen NULL).
Parámetros
odbc-
El objeto de conexión ODBC,
ver la documentación de la función odbc_connect() para más
detalles.
catalog-
El catálogo ('calificativo' en el argot ODBC 2).
schema-
El esquema ('propietario' en el argot ODBC 2).
Este parámetro acepta los siguientes patrones de búsqueda:
% para buscar cero o más caracteres, y _ para buscar un solo carácter.
table-
El nombre.
Este parámetro acepta los siguientes patrones de búsqueda:
% para buscar cero o más caracteres, y _ para buscar un solo carácter.
types-
Si table_type no es un string vacío,
debe contener una lista de valores, separados por comas,
que representan los tipos buscados. Cada valor puede estar
entre comillas simples ('), o sin comillas. Por
ejemplo, 'TABLE','VIEW' o TABLE, VIEW. Si la fuente de datos
no soporta un tipo de tabla dado, odbc_tables()
no devolverá ningún resultado para ese tipo.
Valores devueltos
Devuelve un objeto de resultado ODBC que contiene las informaciones
o false si ocurre un error.
El conjunto de resultados contiene las siguientes columnas:
TABLE_CATTABLE_SCHEMTABLE_NAMETABLE_TYPEREMARKS
Los controladores pueden indicar columnas adicionales.
El conjunto de resultados está ordenado por TABLE_TYPE, TABLE_CAT,
TABLE_SCHEM y TABLE_NAME.
Ejemplos
Ejemplo #1 Lista las Tablas en un Catálogo
<?php
$conn = odbc_connect($dsn, $user, $pass);
$tables = odbc_tables($conn, 'SalesOrders', 'dbo', '%', 'TABLE');
while (($row = odbc_fetch_array($tables))) {
print_r($row);
break; // filas adicionales omitidas por brevedad
}
?>
Resultado del ejemplo anterior es similar a:
Array
(
[TABLE_CAT] => SalesOrders
[TABLE_SCHEM] => dbo
[TABLE_NAME] => Orders
[TABLE_TYPE] => TABLE
[REMARKS] =>
)
