Usar el controlador JDBC

En esta sección se proporciona una serie de instrucciones rápidas para establecer una conexión sencilla a una base de datos de SQL Server con el controlador JDBC de Microsoft SQL Server 2005. Antes de establecer la conexión a una base de datos de SQL Server, SQL Server se debe instalar en el equipo local o en un servidor y el controlador JDBC se debe instalar en el equipo local.

Establecer ruta de clase

El controlador JDBC no forma parte del SDK de Java. Por consiguiente, debe establecer la ruta de clase para que incluya el archivo sqljdbc.jar si desea usarlo. Si en la ruta de clase falta una entrada para sqljdbc.jar, la aplicación genera la excepción común "Clase no encontrada".

El archivo sqljdbc.jar se instala en la siguiente ubicación:

<directorio de instalación>\sqljdbc_<version>\<language>\sqljdbc.jar

El siguiente es un ejemplo de la instrucción CLASSPATH usada para una aplicación de Windows:

CLASSPATH =.;C:\Program Files\Microsoft SQL Server 2005 JDBC Driver\sqljdbc_1.2\enu\sqljdbc.jar

El siguiente es un ejemplo de la instrucción CLASSPATH usada para una aplicación de Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserver2005jdbc/Driver/sqljdbc_1.2/enu/sqljdbc.jar

Nota

En los sistemas de Windows, los nombres de directorio mayores que 8,3 o los nombres de carpetas con espacios puede causar problemas con las rutas de clase. Si considera que se da este tipo de problema, debe mover temporalmente el archivo sqljdbc.jar a un nombre de directorio sencillo como C:\Temp, cambiar la ruta de clase y determinar si de este modo se corrige el problema.

Aplicaciones que se ejecutan directamente en el símbolo del sistema

La ruta de clase se configura en el sistema operativo. Anexe sqljdbc.jar a la ruta de clase del sistema. Además, puede especificar la ruta de clase en la línea de comandos de Java que ejecuta la aplicación con la opción java -classpath.

Aplicaciones que se ejecutan en un IDE

Cada proveedor de IDE ofrece un método distinto para establecer la ruta de clase en el IDE. Establecer sin más la ruta de clase en el sistema operativo no funciona. Debe agregar sqljdbc.jar a la ruta de clase del IDE.

Servlets y JSP

Los servlets y JSP se ejecutan en un motor de servlet/JSP como Tomcat. La ruta de clase se debe establecer de acuerdo con la documentación del motor de servlet/JSP. Establecer sin más la ruta de clase en el sistema operativo no funciona. Algunos motores de servlet/JSP incluyen pantallas de configuración que puede utilizar para establecer la ruta de clase del motor. En este caso, debe adjuntar el archivo JAR del controlador JDBC correcto a la ruta de clase del motor y reiniciar el motor. En otras situaciones, puede configurar el controlador copiando sqljdbc.jar en un directorio específico, con extensión lib, durante la instalación del motor. La ruta de clase del controlador del motor también se puede especificar en un archivo de configuración específico del motor.

Enterprise Java Beans

Enterprise Java Beans (EJB) se ejecuta en un contenedor EJB. Los contenedores EJB son distribuidos por varios proveedores. Los subprogramas Java se ejecutan en un explorador, pero se descargan desde un servidor web. Copie sqljdbc.jar en la raíz del servidor web y especifique el nombre del archivo JAR en la ficha de archivo HTML del subprograma (por ejemplo, <applet ... archive=sqljdbc.jar>).

Establecer una conexión sencilla con una base de datos

Para establecer una conexión a una base de datos con la clase DriverManager, debe registrar primero el controlador como en el ejemplo siguiente:

Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");

Una vez cargado el controlador, puede establecer una conexión con una URL de conexión:

String connectionUrl = "jdbc:sqlserver://localhost:1433;" +
   "databaseName=AdventureWorks;user=MyUserName;password=*****;";
Connection con = DriverManager.getConnection(connectionUrl);

Para obtener más información sobre la conexión con orígenes de datos y el uso de una URL de conexión, consulte Generar URL de conexión y Establecer las propiedades de conexión.

Vea también

Otros recursos

Introducción al controlador JDBC