odbc_tables

(PHP 4, PHP 5)

odbc_tables — Obtém uma lista dos nomes das tabelas guardadas em uma fonte de dados especificado

Descrição

resource odbc_tables ( resource $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:

  • TABLE_QUALIFIER
  • TABLE_OWNER
  • TABLE_NAME
  • TABLE_TYPE
  • REMARKS

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:

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