2.6 DatabaseMetaData详解

DatabaseMetaData接口是由JDBC驱动程序实现的,用于提供底层数据源相关的信息。该接口主要用于为应用程序或工具确定如何与底层数据源交互。应用程序也可以使用DatabaseMetaData接口提供的方法获取数据源信息。

DatabaseMetaData接口中包含超过150个方法,根据这些方法的类型可以分为以下几类:

(1)获取数据源信息。

(2)确定数据源是否支持某一特性或功能。

(3)获取数据源的限制。

(4)确定数据源包含哪些SQL对象以及这些对象的属性。

(5)获取数据源对事务的支持。

DatabaseMetaData接口中有超过40个字段,这些字段都是常量,用于DatabaseMetaData接口中各个方法的返回值。

后面将会简单地介绍DatabaseMetaData接口,列举DatabaseMetaData各种类型的方法作用。关于DatabaseMetaData接口更详细的信息可参考JDBC规范文档。

2.6.1 创建DatabaseMetaData对象

DatabaseMetaData对象的创建比较简单,需要依赖Connection对象。Connection对象中提供了一个getMetadata()方法,用于创建DatabaseMetaData对象。

一旦创建了DatabaseMetaData对象,我们就可以通过该对象动态地获取数据源相关的信息了。下面是创建DatabaseMetaData对象并使用该对象获取数据库表名允许的最大字符数的案例,代码如下:

2.6.2 获取数据源的基本信息

DatabaseMetaData接口中提供了一些方法,用于获取数据源的基本信息,例如URL、用户名等。这些方法如下。

  • getURL():获取数据库URL。
  • getUserName():获取数据库已知的用户。
  • getDatabaseProductName():获取数据库产品名。
  • getDatabaseProductVersion():获取数据库产品的版本。
  • getDriverMajorVersion():获取驱动主版本。
  • getDriverMinorVersion():获取驱动副版本。
  • getSchemaTerm():获取数据库供应商用于Schema的首选术语。
  • getCatalogTerm():获取数据库供应商用于Catalog的首选术语。
  • getProcedureTerm():获取数据库供应商用于Procedure的首选术语。
  • nullsAreSortedHigh():获取null值是否高排序。
  • nullsAreSortedLow():获取null值是否低排序。
  • usesLocalFiles():获取数据库是否将表存储在本地文件中。
  • usesLocalFilePerTable():获取数据库是否为每个表使用一个文件。
  • getSQLKeywords():获取数据库SQL关键字。

下面是这些方法的使用案例,代码如下:

完整代码,读者可参考随书源码mybatis-chapter02项目的com.blog4java.jdbc.Example08测试用例。运行后,控制台输出如下:

注意

由于HSQLDB驱动对DatabaseMetaData接口的getSQLKeywords()方法没有任何实现逻辑,只返回一个空字符串,因此上面的代码获取数据库SQL关键字内容为空。

2.6.3 获取数据源支持特性

DatabaseMetaData接口中提供了大量的方法用于确定数据源是否支持某个或一组特定的特性。除此之外,有些方法用于描述数据源对某一特性的支持级别。例如,下面一些方法用于判断数据源是否支持某些特性。

  • supportsAlterTableWithDropColumn():检索此数据源是否支持带有删除列的ALTER TABLE语句。
  • supportsBatchUpdates():检索此数据源是否支持批量更新。
  • supportsTableCorrelationNames():检索此数据源是否支持表相关名称。
  • supportsPositionedDelete():检索此数据源是否支持定位的DELETE语句。
  • supportsFullOuterJoins():检索此数据源是否支持完整地嵌套外部连接。
  • supportsStoredProcedures():检索此数据源是否存储过程。
  • supportsMixedCaseQuotedIdentifiers():检索此数据源是否将用双引号引起来的大小写混合的SQL标识符视为区分大小写,并以混合大小写方式存储它们。

下面的方法用于判断数据库对某些特性支持的级别。

  • supportsANSI92EntryLevelSQL():检索此数据源是否支持ANSI92入门级SQL语法。
  • supportsCoreSQLGrammar():检索此数据源是否支持ODBC核心SQL语法。

DatabaseMetaData接口中判断数据源特性的方法较多,这里就不一一介绍了,读者需要时可参考JDBC API文档。

2.6.4 获取数据源限制

DatabaseMetaData接口中有一组方法用于获取数据源限制,下面列出其中的一些方法。

  • getMaxRowSize():获取最大行数。
  • getMaxStatementLength():获取此数据库在SQL语句中允许的最大字符数。
  • getMaxTablesInSelect():获取此数据库在SELECT语句中允许的最大表数。
  • getMaxConnections():获取此数据库支持的最大连接数。
  • getMaxCharLiteralLength():获取数据库支持的字符串字面量长度。
  • getMaxColumnsInTable():获取数据库表中允许的最大列数。

这些方法返回值为int类型,当返回值为0时,表示没有限制或限制未知。

2.6.5 获取SQL对象及属性

DatabaseMetaData接口中的一些方法用于获取数据源有关SQL对象的信息,还提供了一些方法获取这些对象的属性信息。这些方法包括:

  • getSchemas():获取Schema信息。
  • getCatalogs():获取Catalog信息。
  • getTables():获取表信息。
  • getPrimaryKeys():获取主键信息。
  • getProcedures():获取存储过程信息。
  • getProcedureColumns():获取给定类别的存储过程参数和结果列的信息。
  • getUDTs():获取用户自定义数据类型。
  • getFunctions():获取函数信息。
  • getFunctionColumns():获取给定类别的函数参数和结果列的信息。

这些方法的返回值是一个ResultSet对象。该ResultSet对象的类型为TYPE_FORWARD_ONLY,并行性为CONCUR_READ_ONLY。可以调用ResultSet对象的getHoldability()方法获取ResultSet对象的可保持性。

2.6.6 获取事务支持

DatabaseMetaData还提供了一些方法用于判断数据源对事务的支持,主要包括:

  • supportsTransactionIsolationLevel(int level):是否支持某一事务隔离级别。
  • supportsTransactions():是否支持事务。
  • getDefaultTransactionIsolation():获取默认的事务隔离级别。
  • supportsMultipleTransactions():是否支持同时开启多个事务。