Incorrect Database Name in Connection URL

JDBC for SQL Server - Herong's Tutorial Examples

∟Incorrect Database Name in Connection URL

This section describes what will happen if incorrect database names specified in the connection URL.

If you selected a wrong database, or the login name has no access to that database, getConnection() method will throw a SQLExection object for you to catch. In this case, the getMessage() method of the SQLExection object will give you the detailed error message.

The tutorial program below shows you an example of the SQLException resulting from a wrong database name in the connection URL:

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

// Obtaining a connection to SQL Server
      con = DriverManager.getConnection(
          "jdbc:sqlserver://localhost\\SQLEXPRESS;"
        + "user=herong;password=T0pSecret;"
        + "database=AdventureWorksWrong");

      con.close();
    } catch (SQLException e) {
      System.err.println("SQLException: "
        +e.getMessage());
    }
  }
}

You will get the following message, if you run it.

herong> java -cp .;mssql-jdbc-9.4.1.jre16.jar WrongDatabase.java

SQLException: Cannot open database "AdventureWorksWrong" requested by
the login. The login failed. ClientConnectionId:
d72c009b-1cf0-425d-b315-2d7618a5df26

The error message is not so accurate. The login is correct. The select database operation fails, because database "AdventureWorksWrong" does not exist on the SQL Server.