Метод getTables (SQLServerDatabaseMetaData)

  • Статья

Скачать драйвер JDBC

Возвращает описание таблиц, доступных в заданном каталоге, схеме или по шаблону имени таблицы.

Синтаксис

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

Параметры

catalog

Значение типа String, содержащее имя каталога. Задание значения NULL для этого параметра указывает на то, что имя каталога использовать не нужно.

schema

Значение типа String, содержащее шаблон имени схемы. Задание значения NULL для этого параметра указывает на то, что имя схемы использовать не нужно.

tableName

Значение типа String, содержащее шаблон имени таблицы.

types

Массив строковых значений, содержащий включаемые типы таблиц. Значение NULL показывает, что нужно включать все типы таблиц.

Возвращаемое значение

Объект SQLServerResultSet.

Исключения

SQLServerException

Remarks

Этот метод getTables определен с помощью метода getTables в интерфейсе java.sql.DatabaseMetaData.

Результирующий набор, возвращаемый методом getTables, включает следующие данные:

Имя Тип Описание
TABLE_CAT String Имя базы данных, в которой расположена указанная таблица.
TABLE_SCHEM String Имя схемы для таблицы.
TABLE_NAME String Имя таблицы.
TABLE_TYPE String Табличный тип.
ПРИМЕЧАНИЯ String Описание таблицы.

Примечание. SQL Server не возвращает значение для этого столбца.
TYPE_CAT String Не поддерживается драйвером JDBC.
TYPE_SCHEM String Не поддерживается драйвером JDBC.
TYPE_NAME String Не поддерживается драйвером JDBC.
SELF_REFERENCING_COL_NAME String Не поддерживается драйвером JDBC.
REF_GENERATION String Не поддерживается драйвером JDBC.

Примечание

Дополнительные сведения о данных, возвращаемых методом getTables, см. в разделе "sp_tables (Transact-SQL)" электронной документации по SQL Server.

Пример

В следующем примере показано, как использовать метод getTables для возврата сведений о описании таблицы Person.Contact в образце базы данных 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();  
   }  
}

См. также:

Методы SQLServerDatabaseMetaData
Элементы SQLServerDatabaseMetaData
Класс SQLServerDatabaseMetaData