odbc_tables

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_tablesLista las tablas de una fuente

Descripción

odbc_tables(
    Odbc\Connection $odbc,
    ?string $catalog = null,
    ?string $schema = null,
    ?string $table = null,
    ?string $types = null
): Odbc\Result|false

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:

  • 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 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.

Valores devueltos

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
Drivers can report additional columns.

El conjunto de resultados está ordenado por TABLE_TYPE, TABLE_CAT, TABLE_SCHEM y TABLE_NAME.

Historial de cambios

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.

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
}
?>

El resultado del ejemplo sería algo similar a:

Array
(
    [TABLE_CAT] => SalesOrders
    [TABLE_SCHEM] => dbo
    [TABLE_NAME] => Orders
    [TABLE_TYPE] => TABLE
    [REMARKS] =>
)

Ver también