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

備註

這個 getTables 方法是由 java.sql.DatabaseMetaData 介面中的 getTables 方法指定。

透過 getTables 方法所傳回的結果將包含下列資訊：

名稱	類型	描述
TABLE_CAT	String	指定之資料表所在的資料庫名稱。
TABLE_SCHEM	String	資料表結構描述名稱。
TABLE_NAME	String	資料表名稱。
TABLE_TYPE	String	資料表類型。
REMARKS	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 驅動程式不支援。

注意

如需 getTable 方法所傳回資料的詳細資訊，請參閱《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 類別