odbc_tables

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

odbc_tablesRestituisce l'elenco delle tabelle presenti in una specifica sorgente di dati

Descrizione

odbc_tables(
    resource $connection_id,
    string $qualifier = ?,
    string $owner = ?,
    string $name = ?,
    string $types = ?
): resource

Restituisce tutte le tabelle nel range richiesto.

Per supportare l'enumerazione dei qualificatori, dei proprietari, e dei tipi di tabella, è disponibile la seguente semantica speciale per i qualifier, owner, name, and table_type:

  • Se qualifier è un carattere di percentuale (%) e owner e name sono stringhe vuote, allora il set di risultati contiene una lista di qualificatori validi per la sorgente dati. (Tutte le colonne eccetto la colonna TABLE_QUALIFIER contengono dei valori NULL.)
  • Se owner è un carattere di percentuale (%) e qualifier e name sono stringhe vuote, allora il set di risultati contiene una lista di proprietari validi per la sorgente dati. (Tutte le colonne eccetto la colonna TABLE_OWNER contengono dei valori NULL.)
  • Se table_type è un carattere di percentuale (%) e qualifier, owner e name sono stringhe vuote, allora il set di risultati contiene una lista di tipi della tabella validi per la sorgente dati. (Tutte le colonne eccetto la colonna TABLE_TYPE contengono dei valori NULL.)

Elenco dei parametri

connection_id

L'identificativo di connessione ODBC, vedere odbc_connect() per ulteriori dettagli.

qualifier

Il qualificatore.

owner

Il proprietario. Accetta dei pattern di ricerca ('%' per trovare zero o più caratteri e '_' per trovare un carattere singolo).

name

Il nome. Accetta dei pattern di ricerca ('%' per trovare zero o più caratteri e '_' per trovare un carattere singolo).

types

Se table_type non è una stringa vuota, esso dovrà contenere una lista di valori separati da virgola per i tipi di interesse; ogni valore potrebbe essere racchiuso tra virgolette singole (') o meno. Per esempio, "'TABLE','VIEW'" o "TABLE, VIEW". Se la sorgente dati non supporta un tipo della tabella specificata, odbc_tables() non restituisce nessun risultato per quel tipo.

Valori restituiti

Restituisce un identificatore di risultato ODBC contenente le informazioni o false in caso di fallimento.

Il set di risultati ha le seguenti colonne:

  • TABLE_QUALIFIER
  • TABLE_OWNER
  • TABLE_NAME
  • TABLE_TYPE
  • REMARKS

Il set di risultati è ordinato da TABLE_TYPE, TABLE_QUALIFIER, TABLE_OWNER e TABLE_NAME.

Vedere anche: