ID do artigo: 313100 - �ltima revis�o: ter�a-feira, 15 de fevereiro de 2011 - Revis�o: 3.3

COMO: Introdu��o ao Microsoft JDBC

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que est� a utilizar. Foi desactivado o conte�do do artigo, que pode n�o ser relevante para si.

Este artigo descreve como se conectar ao SQL Server 2000 usando o driver do Microsoft SQL Server 2000 para JDBC.

OBSERVA��O: Para obter instru��es sobre a instala��o para o driver do Microsoft SQL Server 2000 para JDBC, consulte o Guia de instala��o do driver do Microsoft SQL Server 2000 para JDBC.

Ap�s a instala��o do driver do Microsoft SQL Server 2000 para JDBC, � poss�vel se conectar a partir do seu programa com o seu banco de dados de duas maneiras: com um URL de conex�o ou com uma fonte de dados JNDI. Este artigo descreve como configurar e testar a conex�o do seu banco de dados usando um URL de conex�o.

Uma maneira de se conectar a um banco de dados � por meio do Gerenciador de driver JDBC usando o m�todo getConnection da classe DriverManager. A maneira mais simples de usar esse m�todo � atrav�s de um par�metro de seq��ncia que cont�m um URL, um nome de usu�rio e uma senha. As seguintes se��es deste artigo descrevem como carregar o driver do Microsoft SQL Server 2000 para JDBC a partir do seu programa JDBC.

Voltar para o in�cio

Para definir a vari�vel CLASSPATH

Os arquivos .jar do driver do Microsoft SQL Server 2000 para JDBC devem ser escutados na sua vari�vel CLASSPATH. A vari�vel CLASSPATH � a seq��ncia de procura que a m�quina virtual Java (JVM) usa para localizar os drivers JDBC no seu computador. Se os drivers n�o estiverem listados na sua vari�vel CLASSPATH, a seguinte mensagem de erro ser� exibida ao tentar carregar o driver:

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

Defina a vari�vel CLASSPATH do seu sistema para incluir as seguintes entradas:

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

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

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

Voltar para o in�cio

Para registrar o driver

Registrar o driver instrui o Gerenciador de driver JDBC sobre qual driver carregar. Ao carregar um driver usando a fun��o class.forName, � necess�rio especificar o nome do driver. Este � o nome do driver para o driver do Microsoft SQL Server 2000 para JDBC:

com.microsoft.jdbc.sqlserver.SQLServerDriver

O seguinte exemplo de c�digo demonstra como registrar o driver:

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

Voltar para o in�cio

Para passar o URL de conex�o

� necess�rio passar suas informa��es de conex�o de banco de dados na forma de um URL de conex�o. Este � um modelo de URL para o driver do Microsoft SQL Server 2000 para JDBC: Substitua os valores para o seu banco de dados:

jdbc:microsoft:sqlserver://servername:1433

O seguinte exemplo de c�digo demonstra como especificar um URL de conex�o:

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

Os valores do nome do servidor podem ser um endere�o IP ou um nome de host (presumindo que sua rede resolve nomes de host para endere�os IP). � poss�vel testar isso realizando um ping no nome de host e verificando se recebe uma resposta com o endere�o IP correto.

O valor num�rico ap�s o nome do servidor � o n�mero da porta na qual o banco de dados est� escutando. Os valores listados anteriormente neste artigo s�o exemplos de valores padr�o. Verifique se substituiu o n�mero da porta que seu banco de dados est� usando.

Para obter uma lista completa de par�metros de URL de conex�o, consulte a Ajuda em HTML do driver do Microsoft SQL Server 2000 para JDBC, ou consulte o Guia online. Consulte a se��o "Propriedades da seq��ncia de conex�o".

Voltar para o in�cio

Exemplo de c�digo para testar a conex�o

O seguinte exemplo de c�digo tenta conectar-se ao banco de dados e exibe o nome, a vers�o e os cat�logos dispon�veis do banco de dados. Substitua as propriedades do servidor pelos valores para 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:

A conex�o teve �xito!
Informa��es sobre o driver
        Nome do driver: SQLServer
        Vers�o do driver: 2.2.0022

Informa��es sobre o banco de dados
        Nome do banco de dados: Microsoft SQL Server
        Vers�o do banco 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 Edition no Windows NT 5.1 (Compila��o 2600: )

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

Voltar para o in�cio

Solu��o b�sica de problemas de conectividade

Estas s�o mensagens de erro comuns que podem ocorrer ao tentar se conectar ao seu servidor SQL:

java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC][SQLServer]Logon falhou para usu�rio "usu�rio". Motivo: N�o est� associado a uma conex�o SQL Server confi�vel.

Essa mensagem de erro ocorre se o modo de autentica��o SQL Server 2000 for definido como modo de autentica��o do Windows. O driver do Microsoft SQL Server 2000 para JDBC n�o suporta a conex�o usando autentica��o do Windows NT. � necess�rio definir o modo de autentica��o do seu SQL Server para modo misto, que permite as autentica��es do Windows e do SQL Server.

java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC]Esta vers�o do driver JDBC suporta apenas Microsoft SQL Server 2000. Voc� pode atualizar para SQL Server 2000 ou localizar outra vers�o do driver.

Essa mensagem de erro ocorre ao tentar se conectar a uma vers�o do SQL Server anterior � SQL Server 2000. O driver do Microsoft SQL Server 2000 para JDBC suporta a conectividade apenas com SQL Server 2000.

Voltar para o in�cio

kbsqlmanagementtools kbhowtomaster KB313100

Voltar para o in�cio

This site in other countries/regions:

COMO: Introdu��o ao Microsoft JDBC

Nesta p�gina

Sum�rio

Para definir a vari�vel CLASSPATH

Para registrar o driver

Para passar o URL de conex�o

Exemplo de c�digo para testar a conex�o

Solu��o b�sica de problemas de conectividade

Palavras-chave:�

Outros Sites de Suporte

Comunidades

Tradu��es deste artigo