Listing All Databases - getCatalogs()

JDBC Tutorials - Herong's Tutorial Examples - Version 3.03, by Dr. Herong Yang

JDBC Tutorials - Herong's Tutorial Examples

∟Microsoft JDBC Driver - DatabaseMetaData Object

∟Listing All Databases - getCatalogs()

This section describes how to get a list of all databases on the SQL Server through the DatabaseMetaData object.

If you want to list all databases on the SQL Server, you can use the DatabaseMetaData method: getCatalogs(). It returns all databases in a ResultSet object with one field, TABLE_CAT, containing the database name.

Note that a JDBC catalog is mapped to SQL Server database.

The tutorial Java program below shows you how to list all databases on the SQL Server:

/* ListDatabases.java
 - Copyright (c) 2015, HerongYang.com, All Rights Reserved.
 */
import java.sql.*;
public class ListDatabases {
  public static void main(String [] args) {
    Connection con = null;
    try {

      con = DriverManager.getConnection(
          "jdbc:sqlserver://localhost\\SQLEXPRESS;"
        + "user=sa;password=HerongY@ng;"
        + "database=AdventureWorks2014");

      DatabaseMetaData meta = con.getMetaData();
      ResultSet res = meta.getCatalogs();
      System.out.println("List of databases: "); 
      while (res.next()) {
         System.out.println("   "
           +res.getString("TABLE_CAT"));
      }
      res.close();

      con.close();
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

Here is the output of the program:

C:\herong>\Progra~1\java\jdk1.8.0_45\bin\java 
   -cp .;\local\lib\sqljdbc41.jar ListDatabases

List of databases:
   AdventureWorks2014
   master
   model
   msdb
   tempdb

Last update: 2015.

Table of Contents

About This Book

JDBC (Java Database Connectivity) Introduction

JDK (Java SE) Installation

Installing and Running Java DB - Derby

Derby (Java DB) JDBC Driver

Derby (Java DB) JDBC DataSource Objects

Java DB (Derby) - DML Statements

Java DB (Derby) - ResultSet Objects of Queries

Java DB (Derby) - PreparedStatement

MySQL Installation on Windows