Compartilhar via

Método getTables (SQLServerDatabaseMetaData)

  • Artigo

Baixar o JDBC Driver

Recupera uma descrição das tabelas disponíveis no padrão de nome de catálogo, esquema ou tabela fornecido.

Sintaxe

  
public java.sql.ResultSet getTables(java.lang.String catalog,  
                                    java.lang.String schema,  
                                    java.lang.String table,  
                                    java.lang.String[] types)

parâmetros

catalog

Uma String que contém o nome do catálogo. Fornecer um nulo a esse parâmetro indica que o nome do catálogo não precisa ser usado.

schema

Uma String que contém o padrão de nome do esquema. Fornecer um nulo a esse parâmetro indica que o nome de esquema não precisa ser usado.

tableName

Uma String que contém o padrão de nome de tabela.

types

Uma matriz de cadeia de caracteres que contém os tipos de tabelas a serem incluídos. Nulo indica que todos os tipos de tabelas devem ser incluídos.

Valor retornado

Um objeto SQLServerResultSet.

Exceções

SQLServerException

Comentários

Esse método getTables é especificado pelo método getTables na interface java.sql.DatabaseMetaData.

O conjunto de resultados retornado pelo método getTables conterá as seguintes informações:

Nome Tipo Descrição
TABLE_CAT Cadeia de caracteres O nome do banco de dados no qual a tabela especificada reside.
TABLE_SCHEM Cadeia de caracteres O nome do esquema da tabela.
TABLE_NAME Cadeia de caracteres O nome da tabela.
TABLE_TYPE Cadeia de caracteres O tipo de tabela.
COMENTÁRIOS Cadeia de caracteres A descrição da tabela.

Observação: o SQL Server não retorna um valor para essa coluna.
TYPE_CAT Cadeia de caracteres Não há suporte do JDBC Driver.
TYPE_SCHEM Cadeia de caracteres Não há suporte do JDBC Driver.
TYPE_NAME Cadeia de caracteres Não há suporte do JDBC Driver.
SELF_REFERENCING_COL_NAME Cadeia de caracteres Não há suporte do JDBC Driver.
REF_GENERATION Cadeia de caracteres Não há suporte do JDBC Driver.

Observação

Para saber mais sobre os dados retornados pelo método getTables, confira "sp_tables (Transact-SQL)" nos Manuais Online do SQL Server.

Exemplo

O exemplo a seguir demonstra como usar o método getTables para retornar as informações de descrição da tabela Person.Contact no banco de dados de exemplo AdventureWorks2022.

public static void executeGetTables(Connection con) {  
   try {  
      DatabaseMetaData dbmd = con.getMetaData();  
      ResultSet rs = dbmd.getTables("AdventureWorks", "Person", "Contact", null);  
      ResultSetMetaData rsmd = rs.getMetaData();  
  
      // Display the result set data.  
      int cols = rsmd.getColumnCount();  
      while(rs.next()) {  
         for (int i = 1; i <= cols; i++) {  
            System.out.println(rs.getString(i));  
         }  
      }  
      rs.close();  
   }   
  
   catch (Exception e) {  
      e.printStackTrace();  
   }  
}

Consulte Também

Métodos SQLServerDatabaseMetaData
Membros SQLServerDatabaseMetaData
Classe SQLServerDatabaseMetaData