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

一个包含目录名称的字符串 。 对此参数提供 Null 值指示无需使用目录名称。

架构

一个包含架构名称模式的字符串 。 对此参数提供 Null 值指示无需使用架构名称。

tableName

一个包含表名称模式的字符串

类型

含有要包含的表类型的字符串数组。 Null 指示应包含所有表类型。

返回值

一个 SQLServerResultSet 对象。

例外

SQLServerException

备注

此 getTables 方法是由 java.sql.DatabaseMetaData 接口中的 getTables 方法指定的。

由 getTables 方法返回的结果集将包含以下信息:

名称 Type 说明
TABLE_CAT 字符串 指定的表所在的数据库的名称。
TABLE_SCHEM 字符串 表架构名称。
TABLE_NAME 字符串 表名称。
TABLE_TYPE 字符串 表类型。
REMARKS 字符串 表的说明。

注意:SQL Server 不会为此列返回值。
TYPE_CAT 字符串 JDBC 驱动程序不支持此类型。
TYPE_SCHEM 字符串 JDBC 驱动程序不支持此类型。
TYPE_NAME 字符串 JDBC 驱动程序不支持此类型。
SELF_REFERENCING_COL_NAME 字符串 JDBC 驱动程序不支持此类型。
REF_GENERATION 字符串 JDBC 驱动程序不支持此类型。

注意

有关 getTables 方法返回的数据的详细信息,请参阅 SQL Server 联机丛书中的“sp_tables (Transact-SQL)”。

示例

以下示例演示了如何使用 getTables 方法返回 AdventureWorks2022 示例数据库中的 Person.Contact 表的表说明信息。

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 类