(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_tables — Lista las tablas de una fuente
$odbc,$catalog = null,$schema = null,$table = null,$types = nullLista las tablas de una fuente.
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:
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).
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).
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).
odbcEl objeto de conexión ODBC, ver la documentación de la función odbc_connect() para más detalles.
catalogEl 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.
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
El conjunto de resultados está ordenado por TABLE_TYPE, TABLE_CAT,
TABLE_SCHEM y TABLE_NAME.
| Versión | Descripción |
|---|---|
| 8.4.0 |
odbc ahora espera una instancia de
Odbc\Connection; anteriormente, se esperaba un resource.
|
| 8.4.0 | Esta función ahora devuelve una instancia de Odbc\Result; anteriormente, se devolvía un resource. |
| 8.0.0 |
schema, table y types
ahora son anulables.
|
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] =>
)