Recupera una descripción de las tablas que están disponibles en el patrón de nombre determinado de catálogo, esquema o tabla.

Sintaxis

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

Parámetros

catalog

Un String que contiene el nombre del catálogo. Si se proporciona un valor NULL en este parámetro, indicará que no es necesario utilizar el nombre de catálogo.

schema

Un String que contiene el modelo de nombre del esquema. Si se proporciona un valor NULL en este parámetro, indicará que no es necesario utilizar el nombre de esquema.

tableName

Un String que contiene el modelo de nombre de la tabla.

types

Una matriz de cadenas que contiene los tipos de tablas que se van a incluir. El valor NULL indica que todos los tipos de tablas deberían estar incluidos.

Valor devuelto

Excepciones

Comentarios

El método getTables especifica este método getTables en la interfaz java.sql.DatabaseMetaData.

El conjunto de resultados devuelto por el método getTables contendrá la siguiente información:

Nombre

Tipo

Descripción

TABLE_CAT

String

Nombre de la base de datos en que reside la tabla especificada.

TABLE_SCHEM

String

Nombre del esquema de tabla.

TABLE_NAME

String

Nombre de la tabla.

TABLE_TYPE

String

Tipo de la tabla.

REMARKS

String

Descripción de la tabla.

SQL Server no devuelve ningún valor para esta columna.

TYPE_CAT

String

El controlador JDBC no lo admite.

TYPE_SCHEM

String

El controlador JDBC no lo admite.

TYPE_NAME

String

El controlador JDBC no lo admite.

SELF_REFERENCING_COL_NAME

String

El controlador JDBC no lo admite.

REF_GENERATION

String

El controlador JDBC no lo admite.

Para obtener más información sobre los datos que devuelve el método getTables, vea "sp_tables (Transact-SQL)" en los Libros en pantalla de SQL Server.

Ejemplo

En el siguiente ejemplo se muestra cómo utilizar el método getTables para devolver información sobre la descripción e la tabla para la tabla Person.Contact en la base de datos de ejemplo SQL Server 2005AdventureWorks.

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();
   }
}

Vea también