odbc_tables
(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_tables — Restituisce l'elenco delle tabelle presenti in una specifica sorgente di dati
Descrizione
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.