Noções básicas sobre o suporte ao Java EE

Baixar Driver JDBC

As seções a seguir documentam como o Microsoft JDBC Driver para SQL Server fornece suporte para a Plataforma Java, Enterprise Edition (Java EE) e recursos opcionais de API do JDBC 3.0. Os exemplos de código-fonte fornecidos neste sistema de Ajuda fornecem uma boa referência como introdução a esses recursos.

Primeiro, tenha certeza de que seu ambiente Java (JDK, JRE) inclua o pacote javax.sql. Este pacote é exigido por qualquer aplicativo do JDBC que usa a API opcional. O JDK 1.5 e as versões posteriores já contêm esse pacote; portanto, você não precisará instalá-lo separadamente.

Nome do driver

O nome de classe do driver é com.microsoft.sqlserver.jdbc.SQLServerDriver.

Para o JDBC Driver 12.6, o driver está contido no arquivo mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar.

Para o JDBC Driver 12.4, o driver está contido em mssql-jdbc-12.4.0.jre8.jar ou no mssql-jdbc-12.4.0.jre11.jar.

Para o JDBC Driver 12.2, o driver está contido no arquivo mssql-jdbc-12.2.0.jre8.jar ou no mssql-jdbc-12.2.0.jre11.jar.

No caso do JDBC Driver 11.2, o driver está contido em mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar ou mssql-jdbc-11.2.0.jre18.jar.

Para o JDBC Driver 10.2, o driver está contido em mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou mssql-jdbc-10.2.0.jre17.jar.

Para o JDBC Driver 9.4, o driver está contido em mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou mssql-jdbc-9.4.1.jre16.jar.

Para o JDBC Driver 9.2, o driver está contido em mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar.

Para o JDBC Driver 8.4, o driver está contido em mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar ou mssql-jdbc-8.4.1.jre14.jar.

Para o JDBC Driver 8.2, o driver está contido em mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar ou mssql-jdbc-8.2.2.jre13.jar.

Para o JDBC Driver 7.4, o driver está contido no mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar ou mssql-jdbc-7.4.1.jre12.jar.

Para o JDBC Driver 7.2, o driver está contido no mssql-jdbc-7.2.2.jre8.jar ou mssql-jdbc-7.2.2.jre11.jar.

Para o JDBC Driver 7.0, o driver está contido no mssql-jdbc-7.0.0.jre8.jar ou mssql-jdbc-7.0.0.jre10.jar.

Para o JDBC Driver 6.4, o driver está contido no mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar ou mssql-jdbc-6.4.0.jre9.jar.

Para o JDBC Driver 6.2, o driver está contido no mssql-jdbc-6.2.2.jre7.jar ou mssql-jdbc-6.2.2.jre8.jar.

Para os JDBC Drivers 4.1, 4.2 e 6.0, o driver está contido nos arquivos sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar.

O nome de classe é usado sempre que você carrega o driver com a classe DriverManager do JDBC e sempre que especifica o nome de classe do driver em qualquer configuração de driver. Por exemplo, configurar uma fonte de dados em um servidor de aplicativos do Java EE pode exigir que você insira o nome de classe do driver.

Fontes de dados

O JDBC driver dá suporte a fontes de dados para Java EE/JDBC 3.0. A classe SQLServerXADataSource do JDBC Driver é implementada por com.microsoft.sqlserver.jdbc.SQLServerXADataSource.

Nomes da fonte de dados

Você pode fazer conexões de banco de dados usando fontes de dados. As fontes de dados disponíveis com o driver JDBC são descritas na tabela a seguir:

Tipo de fonte de dados Nome de classe e descrição
DataSource com.microsoft.sqlserver.jdbc.SQLServerDataSource

A fonte de dados de não pooling.
ConnectionPoolDataSource com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource

A fonte de dados para configurar pools de conexão de servidor de aplicativos do JAVA EE. Geralmente usado quando o aplicativo é executado dentro de um servidor de aplicativos do JAVA EE.
XADataSource com.microsoft.sqlserver.jdbc.SQLServerXADataSource

A fonte de dados para configurar fontes de dados do JAVA EE XA. Geralmente usado quando o aplicativo é executado dentro de um servidor de aplicativos do JAVA EE e um gerenciador de transações XA.

Propriedades da fonte de dados

Todas as fontes de dados oferecem suporte à capacidade de definir e obter qualquer propriedade que está associada com o conjunto de propriedades do driver subjacente.

Exemplos:

setServerName("localhost");
setDatabaseName("AdventureWorks");

Veja a seguir como um aplicativo é conectado usando uma fonte de dados:

//initialize JNDI ..
Context ctx = new InitialContext(System.getProperties());
...
DataSource ds = (DataSource) ctx.lookup("MyDataSource");
Connection c = ds.getConnection("user", "pwd");

Para saber mais sobre as propriedades de fonte de dados, confira Definindo as propriedades da fonte de dados.

Confira também

Visão geral do JDBC Driver