(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_tables — Lista las tablas de una fuente
$odbc
,$catalog
= null
,$schema
= null
,$table
= null
,$types
= null
Lista 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).
odbc
El conector identificador ODBC, ver odbc_connect() para más información.
catalog
The catalog ('qualifier' in ODBC 2 parlance).
schema
The schema ('owner' in ODBC 2 parlance). Este parámetro acepta los siguientes patrones de búsqueda: "%" para coincidir cero o más caracteres, y "_" para coincidir un solo caracter.
table
El nombre. Este parámetro acepta los siguientes patrones de búsqueda: "%" para coincidir cero o más caracteres, y "_" para coincidir un solo caracter.
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.
Returns an ODBC result object que contiene las informaciones
o false
en caso de error.
El conjunto de resultados contiene las siguientes columnas:
TABLE_CAT
TABLE_SCHEM
TABLE_NAME
TABLE_TYPE
REMARKS
El conjunto de resultados está ordenado por TABLE_TYPE
, TABLE_CAT
,
TABLE_SCHEM
y TABLE_NAME
.
Versión | Descripción |
---|---|
8.4.0 |
odbc expects an Odbc\Connection
instance now; previously, a resource was expected.
|
8.4.0 | This function returns an Odbc\Result instance now; previously, a resource was returned. |
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
}
?>
El resultado del ejemplo sería algo similar a:
Array ( [TABLE_CAT] => SalesOrders [TABLE_SCHEM] => dbo [TABLE_NAME] => Orders [TABLE_TYPE] => TABLE [REMARKS] => )