odbc tables()

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök

odbc_tables

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

odbc_tables — Hämta en lista över tabellnamn lagrade i en specifik datakälla

Beskrivning

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

Listar alla tabeller inom det begärda intervallet.

För att stödja uppräkning av kvalifikatorer, ägare och tabelltyper gäller följande specialregler:

  • Om $catalog är ett enda procenttecken (%) och $schema och $table är tomma strängar, innehåller resultatuppsättningen en lista över giltiga kvalifikatorer för datakällan. (Alla kolumner utom TABLE_QUALIFIER innehåller NULL.)
  • Om $schema är ett enda procenttecken (%) och $catalog och $table är tomma strängar, innehåller resultatuppsättningen en lista över giltiga ägare för datakällan. (Alla kolumner utom TABLE_OWNER innehåller NULL.)
  • Om $types är ett enda procenttecken (%) och $catalog, $schema och $table är tomma strängar, innehåller resultatuppsättningen en lista över giltiga tabelltyper för datakällan. (Alla kolumner utom TABLE_TYPE innehåller NULL.)

Parametrar

  • $odbc: ODBC-anslutningsobjektet. Se odbc_connect() för detaljer.
  • $catalog: Katalogen (motsvarar 'qualifier' i ODBC 2-termer).
  • $schema: Schemat (motsvarar 'owner' i ODBC 2-termer). Accepterar följande sökmönster:
 * % för att matcha noll eller fler tecken.
 * _ för att matcha ett enda tecken.
  • $table: Tabellnamnet. Accepterar samma sökmönster som $schema.
  • $types: Om denna parameter inte är en tom sträng, måste den innehålla en kommaseparerad lista över de intressanta typerna, t.ex. `'TABLE','VIEW'` eller `TABLE, VIEW`.

Returnerar

  • Returnerar ett ODBC-resultatobjekt med informationen vid framgång.
  • Returnerar false vid fel.

Resultatuppsättningen innehåller följande kolumner:

  • TABLE_CAT
  • TABLE_SCHEM
  • TABLE_NAME
  • TABLE_TYPE
  • REMARKS

Drivrutiner kan rapportera ytterligare kolumner. Resultatuppsättningen är sorterad efter TABLE_TYPE, TABLE_CAT, TABLE_SCHEM och TABLE_NAME.

Förändringslogg

Version Beskrivning
8.4.0 $odbc förväntar sig nu en instans av Odbc\Connection. Tidigare förväntades en resurs.
8.4.0 Funktionen returnerar nu en instans av Odbc\Result. Tidigare returnerades en resurs.
8.0.0 $schema, $table och $types är nu nullable.

Exempel

Exempel #1 Lista tabeller i en katalog

<?php
$conn = odbc_connect($dsn, $user, $pass);
$tables = odbc_tables($conn, 'SalesOrders', 'dbo', '%', 'TABLE');
while (($row = odbc_fetch_array($tables))) {
    print_r($row);
    break; // fler rader utelämnas för korthetens skull
}
?>

Exempelutdata:

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

Se även

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/function.odbc-tables.php
PHP Funktioner Funktionsreferens Databas-tillägg


Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp Stockholm som har sponsrat Linux.se med webbhotell.