getCatalogs 方法 (SQLServerDatabaseMetaData)

下载 JDBC 驱动程序

检索在连接的服务器中可用的目录名称。

语法

  
public java.sql.ResultSet getCatalogs()  

返回值

一个 SQLServerResultSet 对象。

例外

SQLServerException

备注

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

备注

在 Azure SQL 数据库上,应连接到 master 数据库,以调用 SQLServerDatabaseMetaData.getCatalogs。 SQL 数据库不支持从用户数据库中返回整个目录集。 SQLServerDatabaseMetaData.getCatalogs 使用 sys.databases 视图来获取目录。

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

名称 Type 说明
TABLE_CAT 字符串 目录名称,包括 Microsoft SQL Server 中的系统数据库。

示例

下面的示例展示了如何使用 getCatalogs 方法返回 Microsoft SQL Server 中包含的所有数据库(包括系统数据库)的名称。

public static void executeGetCatalogs(Connection con) {  
   try {  
      DatabaseMetaData dbmd = con.getMetaData();  
      ResultSet rs = dbmd.getCatalogs();  
      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 类