COMO: Come�ar a utilizar o Microsoft JDBC

Artigo: 313100 - Ver produtos para os quais este artigo se aplica.

Este artigo descreve como ligar ao SQL Server 2000 utilizando o Microsoft SQL Server 2000 driver for JDBC.

NOTA: para obter instru��es de instala��o relativas ao Microsoft SQL Server 2000 driver for JDBC, consulte o Microsoft SQL Server 2000 Driver for JDBC Installation Guide.

Depois de instalar o Microsoft SQL Server 2000 driver for JDBC, pode ligar a partir do seu programa � base de dados de duas formas: atrav�s de um URL de liga��o ou de uma origem de dados JNDI. Este artigo descreve como configurar e testar a liga��o � base de dados utilizando um URL de liga��o.

Uma forma de ligar a uma base de dados � atrav�s do gestor de controladores JDBC utilizando o m�todo getConnection da classe DriverManager. A maneira mais simples de utilizar este m�todo consiste em utilizar um par�metro de cadeia que contenha um URL, um nome de utilizador e uma palavra-passe. As sec��es que se seguem neste artigo descrevem como carregar o Microsoft SQL Server 2000 driver for JDBC a partir do programa JDBC.

Definir a vari�vel CLASSPATH

Os ficheiros .jar do Microsoft SQL Server 2000 driver for JDBC t�m de estar listados na vari�vel CLASSPATH. A vari�vel CLASSPATH representa a cadeia de procura utilizada pela m�quina virtual de Java (JVM) para localizar controladores JDBC no computador. Se os controladores n�o estiverem listados na vari�vel CLASSPATH, receber� a seguinte mensagem de erro quando tentar carregar o controlador:

java.lang.ClassNotFoundException: com/microsoft/jdbc/sqlserver/SQLServerDriver

Defina a vari�vel CLASSPATH de sistema de modo a incluir as seguintes entradas:

\O caminho de instala��o\Lib\Msbase.jar
\O caminho de instala��o\Lib\Msutil.jar
\O caminho de instala��o\Lib\Mssqlserver.jar

Este � um exemplo de uma vari�vel CLASSPATH configurada:

CLASSPATH=.;c:\programas\Microsoft SQL Server 2000 Driver for JDBC\lib\msbase.jar;c:\programas\Microsoft SQL Server 2000 Driver for JDBC\lib\msutil.jar;c:\programas\Microsoft SQL Server 2000 Driver for JDBC\lib\mssqlserver.jar

Registar o controlador

A opera��o de registo do controlador indica qual o controlador que o gestor de controladores JDBC dever� carregar. Quando carrega um controlador utilizando a fun��o class.forName, tem de especificar o nome do controlador. Este corresponde ao nome do Microsoft SQL Server 2000 Driver for JDBC:

com.microsoft.jdbc.sqlserver.SQLServerDriver

O seguinte c�digo de exemplo demonstra como registar o controlador:

Driver d = (Driver)Class.forName("com.microsoft.jdbc.sqlserver.SQLServerDriver").newInstance();

Passar o URL de liga��o

Tem de passar as informa��es de liga��o � base de dados sob a forma de um URL de liga��o. Este � um URL modelo para o Microsoft SQL Server 2000 Driver for JDBC. Substitua os valores de acordo com a sua base de dados:

jdbc:microsoft:sqlserver://nomeservidor:1433

O c�digo de exemplo que se segue demonstra como especificar um URL de liga��o:

con = DriverManager.getConnection("jdbc:microsoft:sqlserver://localhost:1433", "userName", "password");

Os valores do nome de servidor podem ser um endere�o de IP ou um nome de anfitri�o (partindo do princ�pio que a sua rede resolve nomes de anfitri�o para endere�os de IP). Para verificar se � o seu caso, pode efectuar o ping ao nome de anfitri�o e verificar se recebe uma resposta com o endere�o de IP correcto.

O valor num�rico a seguir ao nome do servidor corresponde ao n�mero de porta de escuta da base de dados. Os valores listados anteriormente neste artigo s�o valores predefinidos de exemplo. Certifique-se de que substitui o n�mero de porta que a base de dados est� a utilizar.

Para obter uma lista completa de par�metros de URLs de liga��o, consulte a ajuda HTML do Microsoft SQL Server 2000 Driver for JDBC ou consulte o Online Guide. Consulte a sec��o "Connection String Properties".

C�digo de exemplo para testar a liga��o

O seguinte c�digo de exemplo tenta ligar � base de dados e apresenta o nome, a vers�o e os cat�logos dispon�veis da base de dados. Substitua as propriedades do servidor pelos valores do seu servidor:

import java.*;
public class Connect{
     private java.sql.Connection  con = null;
     private final String url = "jdbc:microsoft:sqlserver://";
     private final String serverName= "localhost";
     private final String portNumber = "1433";
     private final String databaseName= "pubs";
     private final String userName = "user";
     private final String password = "password";
     // Informs the driver to use server a side-cursor, 
     // which permits more than one active statement 
     // on a connection.
     private final String selectMethod = "cursor"; 
     
     // Constructor
     public Connect(){}
     
     private String getConnectionUrl(){
          return url+serverName+":"+portNumber+";databaseName="+databaseName+";selectMethod="+selectMethod+";";
     }
     
     private java.sql.Connection getConnection(){
          try{
               Class.forName("com.microsoft.jdbc.sqlserver.SQLServerDriver"); 
               con = java.sql.DriverManager.getConnection(getConnectionUrl(),userName,password);
               if(con!=null) System.out.println("Connection Successful!");
          }catch(Exception e){
               e.printStackTrace();
               System.out.println("Error Trace in getConnection() : " + e.getMessage());
         }
          return con;
      }

     /*
          Display the driver properties, database details 
     */ 

     public void displayDbProperties(){
          java.sql.DatabaseMetaData dm = null;
          java.sql.ResultSet rs = null;
          try{
               con= this.getConnection();
               if(con!=null){
                    dm = con.getMetaData();
                    System.out.println("Driver Information");
                    System.out.println("\tDriver Name: "+ dm.getDriverName());
                    System.out.println("\tDriver Version: "+ dm.getDriverVersion ());
                    System.out.println("\nDatabase Information ");
                    System.out.println("\tDatabase Name: "+ dm.getDatabaseProductName());
                    System.out.println("\tDatabase Version: "+ dm.getDatabaseProductVersion());
                    System.out.println("Avalilable Catalogs ");
                    rs = dm.getCatalogs();
                    while(rs.next()){
                         System.out.println("\tcatalog: "+ rs.getString(1));
                    } 
                    rs.close();
                    rs = null;
                    closeConnection();
               }else System.out.println("Error: No active Connection");
          }catch(Exception e){
               e.printStackTrace();
          }
          dm=null;
     }     
     
     private void closeConnection(){
          try{
               if(con!=null)
                    con.close();
               con=null;
          }catch(Exception e){
               e.printStackTrace();
          }
     }
     public static void main(String[] args) throws Exception
       {
          Connect myDbTest = new Connect();
          myDbTest.displayDbProperties();
       }
}

Se este c�digo tiver �xito, o resultado ser� semelhante ao seguinte:

Liga��o estabelecida com �xito!
Informa��es sobre o controlador
        Nome do controlador: SQLServer
        Vers�o do controlador: 2.2.0022

Informa��es sobre a base de dados
        Nome da base de dados: Microsoft SQL Server
        Vers�o da base de dados: Microsoft SQL Server  2000 - 8.00.384 (Intel X86)
        23 de Maio de 2001 00:02:52
        Copyright (c) 1988-2000 Microsoft Corporation
        Desktop Engine on Windows NT 5.1 (Build 2600: )

Cat�logos dispon�veis
        cat�logo: master
        cat�logo: msdb
        cat�logo: pubs
        cat�logo: tempdb

Resolu��o de problemas de conectividade b�sica

Estas s�o mensagens de erro comuns que poder�o ocorrer quando tentar ligar ao SQL Server:

java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC][SQLServer]Login failed for user 'utilizador'. Reason: Not associated with a trusted SQL Server connection.

Esta mensagem de erro ocorrer� se o modo de autentica��o do SQL Server 2000 estiver definido como autentica��o do Windows. O Microsoft SQL Server 2000 driver for JDBC n�o suporta liga��es que utilizem a autentica��o do Windows NT. Tem de definir o modo de autentica��o do SQL Server como modo misto, o que permite a autentica��o do Windows e a autentica��o do SQL Server.

java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC]This version of the JDBC driver only supports Microsoft SQL Server 2000. You can either upgrade to SQL Server 2000 or possibly locate another version of the driver.

Esta mensagem de erro ocorrer� quando tentar ligar a uma vers�o do SQL Server anterior � do SQL Server 2000. O Microsoft SQL Server 2000 driver for JDBC suporta apenas conectividade com o SQL Server 2000.