An updated version of SQL Server JDBC Driver 3.0 that supports SQL Azure Database is available

Article translations Article translations
Article ID: 2504052 - View products that this article applies to.
Expand all | Collapse all

On This Page

SUMMARY

Microsoft released an updated version of Microsoft SQL Server Java Database Connectivity (JDBC) Driver to support Microsoft SQL Azure Database. This updated version supersedes the release version of SQL Server JDBC Driver 3.0.

This article contains more information about this updated release. Additionally, this article describes an issue with the JDBC API getSchemas method when the release version of SQL Server JDBC Driver 3.0 is used.

MORE INFORMATION

This updated driver has version number 3.0.1301.202. This is the first update that supports SQL Azure Database after the release version of SQL Server JDBC Driver 3.0.

Issue that is fixed

Cannot access schema information by using the release version of SQL Server JDBC Driver 3.0

The release version of SQL Server JDBC Driver 3.0 is 3.0.1301.101. In version 3.0, the driver had to access the master database to obtain the schemas information for a database. This caused the getSchemas method not to work in some circumstances. For example, the getSchemas method will not work if the master database is inaccessible, as in SQL Azure, or if there are collation differences between the master database and other databases. After this update is applied, access to the master database is not required. The getSchemas method will work in SQL Azure and will work if there are collation differences between the master database and other databases.

If your application calls the getSchemas method by using an SQL Azure Database connection that uses this version of the SQL Server JDBC driver, you receive the following error message: 
Error message: Reference to database and/or server name in 'master.sys.schemas' is not supported

com.microsoft.sqlserver.jdbc.SQLServerException: Reference to database and/or server name in 'master.sys.schemas' is not supported in this version of SQL Server.
at com.microsoft.sqlserver.jdbc.SQLServerException.makeFromDatabaseError(SQLServerException.java:197)
at com.microsoft.sqlserver.jdbc.SQLServerStatement.getNextResult(SQLServerStatement.java:1493)
at com.microsoft.sqlserver.jdbc.SQLServerStatement.doExecuteStatement(SQLServerStatement.java:775)
at com.microsoft.sqlserver.jdbc.SQLServerStatement$StmtExecCmd.doExecute(SQLServerStatement.java:676)
at com.microsoft.sqlserver.jdbc.TDSCommand.execute(IOBuffer.java:4575)
at com.microsoft.sqlserver.jdbc.SQLServerConnection.executeCommand(SQLServerConnection.java:1400)
at com.microsoft.sqlserver.jdbc.SQLServerStatement.executeCommand(SQLServerStatement.java:179)
at com.microsoft.sqlserver.jdbc.SQLServerStatement.executeStatement(SQLServerStatement.java:154)
at com.microsoft.sqlserver.jdbc.SQLServerStatement.executeQueryInternal(SQLServerStatement.java:619)
at com.microsoft.sqlserver.jdbc.SQLServerDatabaseMetaData.getResultSetFromInternalQueries(SQLServerDatabaseMetaData.java:224)
at com.microsoft.sqlserver.jdbc.SQLServerDatabaseMetaData.getSchemasInternal(SQLServerDatabaseMetaData.java:1292)
at com.microsoft.sqlserver.jdbc.SQLServerDatabaseMetaData.getSchemas(SQLServerDatabaseMetaData.java:1227)

How to obtain this update

A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that described in this article. Apply this hotfix only to systems that are experiencing the problem described in this article. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.

If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft website:
http://support.microsoft.com/contactus/?ws=support
Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

Restart requirement

You do not have to restart the computer after you apply this update.

Update replacement information

This update does not replace any other updates.

REFERENCES

For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:
824684 Description of the standard terminology that is used to describe Microsoft software updates

Properties

Article ID: 2504052 - Last Review: February 2, 2011 - Revision: 2.0
APPLIES TO
  • Microsoft SQL Server Java Database Connectivity Driver 3.0
Keywords: 
kbautohotfix kbexpertiseinter kbprb kbsurveynew kbfix kbbug kbqfe kbhotfixserver KB2504052

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com