Метод getTables (SQLServerDatabaseMetaData)

Статья
05/23/2023

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

Синтаксис

  
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

Замечания

Этот метод 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

Поделиться через