DatabaseMetaData 接口提供数据源的相关信息,应用程序可以据此判断数据源是否支持某项功能或一组功能。例如,是否支持可滚动结果集,能否使用 Connection.commit 和 Connection.rollback。应用程序还可以借助 DatabaseMetaData 接口了解:

  • 数据源的限制
  • 数据源中包含的 SQL 对象及其属性
  • 数据源提供的事务支持

DatabaseMetaData 接口还定义了 40 多个字段,用作多个元数据方法返回值中的常量。

本章概述 DatabaseMetaData 接口,并通过示例介绍元数据方法的分类,以及 JDBC 4.2 API 中新增或修改的方法。完整定义请参阅 JDBC API 规范。

注意:JDBC 还定义了 ResultSetMetaData 接口,该接口会在第 15 章“结果集”中介绍。

7.1 创建 DatabaseMetaData 对象

DatabaseMetaData 对象通过 Connection 的 getMetaData 方法创建。获取该对象后,应用程序就可以在运行时查询底层数据源的信息。代码示例 7-1 展示了如何创建 DatabaseMetaData 对象,并用它查询表名允许的最大长度。

1
2
3
// con is a Connection object
DatabaseMetaData dbmd = con.getMetaData();
int maxLen = dbmd.getMaxTableNameLength();

代码示例 7-1 创建和使用 DatabaseMetaData 对象

赞助商

7.2 获取基本信息

部分 DatabaseMetaData 方法用于查询数据源的基本信息及实现细节,例如:

  • getURL
  • getUserName
  • getDatabaseProductVersion、getDriverMajorVersion 和 getDriverMinorVersion
  • getSchemaTerm、getCatalogTerm 和 getProcedureTerm
  • nullsAreSortedHigh 和 nullsAreSortedLow
  • usesLocalFiles 和 usesLocalFilePerTable
  • getSQLKeywords

7.3 判断功能支持情况

DatabaseMetaData 提供了大量方法,用于判断驱动程序或底层数据源是否支持某项功能或一组功能。有些方法只返回是否支持,有些方法则进一步说明支持级别。

用于判断单项能力是否受支持的方法示例包括:

  • supportsAlterTableWithDropColumn
  • supportsBatchUpdates
  • supportsTableCorrelationNames
  • supportsPositionedDelete
  • supportsFullOuterJoins
  • supportsStoredProcedures
  • supportsMixedCaseQuotedIdentifiers

用于描述支持级别的方法示例包括:

  • supportsANSI92EntryLevelSQL
  • supportsCoreSQLGrammar

7.4 数据源限制

另一组方法用于查询数据源的各项限制,例如:

  • getMaxRowSize
  • getMaxStatementLength
  • getMaxTablesInSelect
  • getMaxConnections
  • getMaxCharLiteralLength
  • getMaxColumnsInTable

这些方法通常返回 int 值。返回值为 0 表示没有限制,或者该限制未知。

7.5 SQL 对象及其属性

还有一些 DatabaseMetaData 方法用于查询数据源中的 SQL 对象及其属性。这组方法通常返回 ResultSet 对象,每一行对应一个具体的 SQL 对象。例如,getUDTs 会返回一个 ResultSet,其中每一行都对应数据源中定义的一个 UDT。

这一类方法的示例包括:

  • getSchemas
  • getCatalogs
  • getTables
  • getPrimaryKeys
  • getProcedures
  • getProcedureColumns
  • getUDTs
  • getFunctions
  • getFunctionColumns

DatabaseMetaData 方法返回的 ResultSet 对象,其结果集类型为 TYPE_FORWARD_ONLY,并发模式为 CONCUR_READ_ONLY。可以通过 ResultSet.getHoldability 判断该 ResultSet 的保持性,因为默认保持性取决于具体实现。

JDBC 驱动程序供应商可以在标准列之外返回额外的列,但这些额外列必须通过列标签访问。这样一来,未来版本的 JDBC 规范就能够在不破坏现有应用程序的前提下,为现有 DatabaseMetaData 方法增加新列。

7.6 事务支持

少量方法用于描述数据源支持的事务语义,例如:

  • supportsMultipleTransactions
  • getDefaultTransactionIsolation

7.7 新方法

JDBC 4.2 API 引入了以下新的 DatabaseMetaData 方法:

  • supportsRefCursors:用于指示驱动程序或底层数据源是否支持 REF CURSOR。
  • getMaxLogicalLobSize:用于获取驱动程序支持的最大逻辑 LOB 大小。

这些方法的完整定义可参见 JDBC API 规范中的 Javadoc。

7.8 修改的方法

JDBC 4.2 API 修改了以下现有 DatabaseMetaData 方法的定义:

  • getIndexInfo:返回结果中的 CARDINALITY 和 PAGES 列现在返回 long 值。

这些方法的更新定义见 JDBC 4.2 API 规范。