(PHP 4, PHP 5)
odbc_tables — Obtém uma lista dos nomes das tabelas guardadas em uma fonte de dados especificado
$connection_id
[, string $qualifier
[, string $owner
[, string $name
[, string $types
]]]] )
Lista todas as tabelas no intervalo solicitado. Retorna um identificador de resultado
contendo a informação ou FALSE
em caso de falha.
O conjunto de resultados tem as seguintes colunas:
O conjunto de resultados é ordenado por TABLE_TYPE, TABLE_QUALIFIER, TABLE_OWNER e TABLE_NAME.
Os argumentos owner
e name
aceitam caracteres de busca ('%' para buscar zero ou mais caracteres
e '_' para buscar um único caractere).
Para suportar a enumeração de qualifiers, owners, e table types,
a seguinte semantica especial para
qualifier
, owner
,
name
, e
table_type
esta disponível:
qualifier
é um único caractere
de porcentagem (%) e owner
e
name
são strings vazias, então o conjunto de resultados
contém uma lista dos qualifiers válidos para a fonte de dados.
(Todas as colunas exceto a coluna TABLE_QUALIFIER contém NULLs.)
owner
é um único caractere de
porcentagem (%) e qualifier
e
name
são strings vazias, então o conjunto de resultados
contém uma lista dos owners válidos para a fonte de dados.
(Todas as colunas exceto a coluna TABLE_OWNER contém NULLs.)
table_type
é um único caractere de
porcentagem (%) e qualifier
,
owner
e name
são strings vazias, então o conjunto de resultados contém uma lista
de table types válido para a fonte de dados.
(Todas as colunas exceto a coluna TABLE_TYPE contém NULLs.)
Se table_type
não for uma string vazia,
deve conter uma lista de valores separados por vírgula para os
tipos que interessem, cada valor pode estar entre aspas simples (')
ou sem aspas. Poe exemplo, "'TABLE','VIEW'" ou "TABLE, VIEW". Se a
fonte de dados não suportar o tipo de tabela especificado,
odbc_tables() não retorna nenhum resultado para este tipo.
Veja também odbc_tableprivileges() para obter os privilégios associados.