Compartir a través de


Empleo del controlador JDBC

Descargar 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 mediante Microsoft JDBC Driver para SQL Server. 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.

Elección del archivo JAR adecuado

El controlador Microsoft JDBC Driver proporciona diferentes archivos JAR que se usarán en función de su configuración preferida de Java Runtime Environment (JRE), del modo siguiente:

Microsoft JDBC Driver 12.8 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-12.8.0.jre8.jar y mssql-jdbc-12.8.0.jre11.jar.

Microsoft JDBC Driver 12.6 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-12.6.0.jre8.jar y mssql-jdbc-12.6.0.jre11.jar.

Microsoft JDBC Driver 12.4 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-12.4.0.jre8.jar y mssql-jdbc-12.4.0.jre11.jar.

Microsoft JDBC Driver 12.2 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-12.2.0.jre8.jar y mssql-jdbc-12.2.0.jre11.jar.

Microsoft JDBC Driver 11.2 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar y mssql-jdbc-11.2.0.jre18.jar.

Microsoft JDBC Driver 10.2 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar y mssql-jdbc-10.2.0.jre17.jar.

El controlador Microsoft JDBC Driver 9.4 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar y mssql-jdbc-9.4.1.jre16.jar.

El controlador Microsoft JDBC Driver 9.2 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar y mssql-jdbc-9.2.1.jre15.jar.

El controlador Microsoft JDBC Driver 8.4 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar y mssql-jdbc-8.4.1.jre14.jar.

El controlador Microsoft JDBC Driver 8.2 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar y mssql-jdbc-8.2.2.jre13.jar.

El controlador Microsoft JDBC Driver 7.4 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar y mssql-jdbc-7.4.1.jre12.jar.

El controlador Microsoft JDBC Driver 7.2 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-7.2.2.jre8.jar y mssql-jdbc-7.2.2.jre11.jar.

El controlador Microsoft JDBC Driver 7.0 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-7.0.0.jre8.jar y mssql-jdbc-7.0.0.jre10.jar.

El controlador Microsoft JDBC Driver 6.4 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar y mssql-jdbc-6.4.0.jre9.jar.

El controlador Microsoft JDBC Driver 6.2 para SQL Server proporciona los archivos de biblioteca de clases mssql-jdbc-6.2.2.jre7.jar y mssql-jdbc-6.2.2.jre8.jar.

Los controladores Microsoft JDBC Driver 6.0 y 4.2 para SQL Server proporcionan los archivos de biblioteca de clases sqljdbc41.jar y sqljdbc42.jar.

El controlador Microsoft JDBC Driver 4.1 para SQL Server proporciona el archivo de biblioteca de clases sqljdbc41.jar.

La elección determinará las características disponibles. Para obtener más información sobre el archivo JAR que se debe seleccionar, vea Requisitos del sistema para el controlador JDBC.

Establecer classpath

Los archivos JAR de JDBC Driver de Microsoft no forman parte del SDK de Java y deben incluirse en la ruta de clases de la aplicación de usuario.

Si usa el controlador JDBC Driver 12.8, configure la ruta de clases para incluir mssql-jdbc-12.8.0.jre8.jar o mssql-jdbc-12.8.0.jre11.jar.

Si usa el controlador JDBC Driver 12.6, configure la ruta de clases para incluir mssql-jdbc-12.6.0.jre8.jar o mssql-jdbc-12.6.0.jre11.jar.

Si usa el controlador JDBC Driver 12.4, configure la ruta de clases para incluir mssql-jdbc-12.4.0.jre8.jar o mssql-jdbc-12.4.0.jre11.jar.

Si usa el controlador JDBC Driver 12.2, configure la ruta de clases para incluir mssql-jdbc-12.2.0.jre8.jar o mssql-jdbc-12.2.0.jre11.jar.

Si usa JDBC 11.2, establezca la ruta de clases para incluir mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar o mssql-jdbc-11.2.0.jre18.jar.

Si usa JDBC 10.2, establezca la ruta de clases para incluir mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar o mssql-jdbc-10.2.0.jre17.jar.

Si usa el controlador JDBC 9.4, establezca la ruta de clases para incluir mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar o mssql-jdbc-9.4.1.jre16.jar.

Si usa el controlador JDBC 9.2, establezca la ruta de clases para incluir mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar o mssql-jdbc-9.2.1.jre15.jar.

Si usa JDBC Driver 8.4, establezca la ruta de clases para incluir mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar o mssql-jdbc-8.4.1.jre14.jar.

Si usa JDBC Driver 8.2, establezca la ruta de clases para incluir mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar o mssql-jdbc-8.2.2.jre13.jar.

Si usa el controlador JDBC Driver 7.4, establezca la ruta de clases para incluir mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar o mssql-jdbc-7.4.1.jre12.jar.

Si usa el controlador JDBC Driver 7.2, configure la ruta de clases para incluir mssql-jdbc-7.2.2.jre8.jar o mssql-jdbc-7.2.2.jre11.jar.

Si usa el controlador JDBC Driver 7.0, configure la ruta de clases para incluir mssql-jdbc-7.0.0.jre8.jar o mssql-jdbc-7.0.0.jre10.jar.

Si usa el controlador JDBC Driver 6.4, configure la ruta de clases para incluir mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar o mssql-jdbc-6.4.0.jre9.jar.

Si usa el controlador JDBC Driver 6.2, configure la ruta de clases para incluir mssql-jdbc-6.2.2.jre7.jar o mssql-jdbc-6.2.2.jre8.jar.

Si usa el controlador JDBC Driver 4.1 o 4.2, configure la ruta de clases para incluir el archivo sqljdbc41.jar o sqljdbc42.jar de la descarga del controlador correspondiente.

Si falta una entrada en la ruta de clases para el archivo JAR adecuado, una aplicación lanzará la excepción común Class not found.

Para el controlador Microsoft JDBC Driver 12.8

Los archivos mssql-jdbc-12.8.0.jre8.jar o mssql-jdbc-12.8.0.jre11.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.8 for SQL Server\sqljdbc_12.8\enu\mssql-jdbc-12.8.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.8/enu/mssql-jdbc-12.8.0.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga una instancia de Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.8.0.jre8.jar o mssql-jdbc-12.8.0.jre11.jar.

Para el controlador Microsoft JDBC Driver 12.6

Los archivos mssql-jdbc-12.6.0.jre8.jar o mssql-jdbc-12.6.0.jre11.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.6 for SQL Server\sqljdbc_12.6\enu\mssql-jdbc-12.6.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.6/enu/mssql-jdbc-12.6.0.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga una instancia de Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.6.0.jre8.jar o mssql-jdbc-12.6.0.jre11.jar.

Para el controlador Microsoft JDBC Driver 12.4

Los archivos mssql-jdbc-12.4.0.jre8.jar o mssql-jdbc-12.4.0.jre11.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.4 for SQL Server\sqljdbc_12.4\enu\mssql-jdbc-12.4.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.4/enu/mssql-jdbc-12.4.0.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga solo una instancia de Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.4.0.jre8.jar o mssql-jdbc-12.4.0.jre11.jar.

Para Microsoft JDBC Driver 12.2

Los archivos mssql-jdbc-12.2.0.jre8.jar o mssql-jdbc-12.2.0.jre11.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.2 for SQL Server\sqljdbc_12.2\enu\mssql-jdbc-12.2.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.2/enu/mssql-jdbc-12.2.0.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga solo una instancia de Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.2.0.jre8.jar o mssql-jdbc-12.2.0.jre11.jar.

Para JDBC Driver 11.2 de Microsoft

Los archivos mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar o mssql-jdbc-11.2.0.jre18.jar se instalan en las ubicaciones siguientes:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre11.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre17.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre18.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 11.2 for SQL Server\sqljdbc_11.2\enu\mssql-jdbc-11.2.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_11.2/enu/mssql-jdbc-11.2.0.jre11.jar

Asegúrese de que la instrucción CLASSPATH contenga solo un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar o mssql-jdbc-11.2.0.jre18.jar.

Para JDBC Driver 10.2 de Microsoft

Los archivos mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar o mssql-jdbc-10.2.0.jre17.jar se instalan en las ubicaciones siguientes:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre11.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre17.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 10.2 for SQL Server\sqljdbc_10.2\enu\mssql-jdbc-10.2.0.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_10.2/enu/mssql-jdbc-10.2.0.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga una instancia de Microsoft JDBC Driver para SQL Server, como mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar o mssql-jdbc-10.2.0.jre17.jar.

Para el controlador Microsoft JDBC Driver 9.4

Los archivos mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar o mssql-jdbc-9.4.1.jre16.jar se instalan en las ubicaciones siguientes:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre11.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre16.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.4 for SQL Server\sqljdbc_9.4\enu\mssql-jdbc-9.4.1.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.4/enu/mssql-jdbc-9.4.1.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga una instancia de Microsoft JDBC Driver para SQL Server, como mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar o mssql-jdbc-9.4.1.jre16.jar.

Para el controlador Microsoft JDBC Driver 9.2

Los archivos mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar o mssql-jdbc-9.2.1.jre15.jar se instalan en las ubicaciones siguientes:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre11.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre15.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.2 for SQL Server\sqljdbc_9.2\enu\mssql-jdbc-9.2.1.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.2/enu/mssql-jdbc-9.2.1.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar o mssql-jdbc-9.2.1.jre15.jar.

Para el controlador Microsoft JDBC Driver 8.4

Los archivos mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar o mssql-jdbc-8.4.1.jre14.jar se instalan en las ubicaciones siguientes:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre11.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre14.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.4 for SQL Server\sqljdbc_8.4\enu\mssql-jdbc-8.4.1.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.4/enu/mssql-jdbc-8.4.1.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar o mssql-jdbc-8.4.1.jre14.jar.

Para el controlador Microsoft JDBC Driver 8.2

Los archivos mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar o mssql-jdbc-8.2.2.jre13.jar se instalan en las ubicaciones siguientes:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre11.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre13.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.2 for SQL Server\sqljdbc_8.2\enu\mssql-jdbc-8.2.2.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.2/enu/mssql-jdbc-8.2.2.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar o mssql-jdbc-8.2.2.jre13.jar.

Para el controlador Microsoft JDBC Driver 7.4

Los archivos mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar o mssql-jdbc-7.4.1.jre12.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre11.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre12.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.4 for SQL Server\sqljdbc_7.4\enu\mssql-jdbc-7.4.1.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar o mssql-jdbc-7.4.1.jre12.jar.

Para el controlador Microsoft JDBC Driver 7.2

Los archivos mssql-jdbc-7.2.2.jre8.jar o mssql-jdbc-7.2.2.jre11.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.2 for SQL Server\sqljdbc_7.2\enu\mssql-jdbc-7.2.2.jre11.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.2/enu/mssql-jdbc-7.2.2.jre11.jar

Asegúrese de que la instrucción CLASSPATH solo contenga solo un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-7.2.2.jre8.jar o mssql-jdbc-7.2.2.jre11.jar.

Para el controlador Microsoft JDBC Driver 7.0

Los archivos mssql-jdbc-7.0.0.jre8.jar o mssql-jdbc-7.0.0.jre10.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre10.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.0 for SQL Server\sqljdbc_7.0\enu\mssql-jdbc-7.0.0.jre10.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.0/enu/mssql-jdbc-7.0.0.jre10.jar

Asegúrese de que la instrucción CLASSPATH solo contenga un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-7.0.0.jre8.jar o mssql-jdbc-7.0.0.jre10.jar.

Para el controlador Microsoft JDBC Driver 6.4

Los archivos mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar o mssql-jdbc-6.4.0.jre9.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre7.jar
  
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre9.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.4 for SQL Server\sqljdbc_6.4\enu\mssql-jdbc-6.4.0.jre9.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.4/enu/mssql-jdbc-6.4.0.jre9.jar

Asegúrese de que la instrucción CLASSPATH solo contenga un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar o mssql-jdbc-6.4.0.jre9.jar.

Para el controlador Microsoft JDBC Driver 6.2

Los archivos mssql-jdbc-6.2.2.jre7.jar o mssql-jdbc-6.2.2.jre8.jar se instalan en las siguientes ubicaciones:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre7.jar
  
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre8.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.2 for SQL Server\sqljdbc_6.2\enu\mssql-jdbc-6.2.2.jre8.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.2/enu/mssql-jdbc-6.2.2.jre8.jar

Asegúrese de que la instrucción CLASSPATH solo contenga un Microsoft JDBC Driver para SQL Server, como mssql-jdbc-6.2.2.jre7.jar o mssql-jdbc-6.2.2.jre8.jar.

Para el controlador Microsoft JDBC Driver 4.1, 4.2 y 6.0

El archivo sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar o sqljdbc42.jar se instalan en la siguiente ubicación:

\<installation directory>\sqljdbc_<version>\<language>\sqljdbc.jar  
  
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc4.jar  
  
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc41.jar  
  
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc42.jar  

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Windows:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.0 for SQL Server\sqljdbc_4.2\enu\sqljdbc42.jar

El siguiente fragmento de código es un ejemplo de la instrucción CLASSPATH que se usa para una aplicación Unix/Linux:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.2/enu/sqljdbc42.jar

Asegúrese de que la instrucción CLASSPATH contenga solamente un elemento Microsoft JDBC Driver para SQL Server, como por ejemplo, sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar o sqljdbc42.jar.

Nota:

En los sistemas de Windows, los nombres de directorio superiores a 8.3 o los nombres de carpetas con espacios pueden causar problemas con las rutas de clase. Si sospecha estos tipos de problemas, debería mover temporalmente el archivo sqljdbc.jar, sqljdbc4.jar o sqljdbc41.jar a un directorio de nombre simple, tal como C:\Temp, cambiar la ruta de clases y determinar si el problema se resuelve.

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

La ruta de clase se configura en el sistema operativo. Anexe sqljdbc.jar, sqljdbc4.jar o sqljdbc41.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, sqljdbc4.jar o sqljdbc41.jar a la ruta de clase 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, sqljdbc4.jar o sqljdbc41.jar en un directorio específico, como 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 applets Java se ejecutan en un explorador, pero se descargan desde un servidor web. Copie sqljdbc.jar, sqljdbc4.jar o sqljdbc41.jar en la raíz del servidor web y especifique el nombre del archivo JAR en la pestaña del archivo HTML del applet, por ejemplo, <applet ... archive=mssql-jdbc-***.jar>.

Establecimiento de una conexión sencilla con una base de datos

Para usar la biblioteca de clases sqljdbc.jar, primero las aplicaciones tienen que registrar el controlador del modo siguiente:

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

Una vez cargado el controlador, puede establecer una conexión con una URL de conexión y el método getConnection de la clase DriverManager:

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

Advertencia

La cadena de conexión anterior usa encrypt=false, que no se recomienda para su uso en producción. Para obtener más información sobre cómo cifrar la conexión de base de datos con JDBC, consulte Conexión con cifrado.

A partir de la API 4.0 de JDBC, el método DriverManager.getConnection() se ha mejorado para que los controladores JDBC se carguen automáticamente. Por tanto, no es necesario que las aplicaciones llamen al método Class.forName para registrar o cargar el controlador al usar bibliotecas .jar de controladores.

Cuando se llama al método getConnection de la clase DriverManager, se busca un controlador apropiado en el conjunto de controladores JDBC registrados. El archivo sqljdbc4.jar, sqljdbc41.jar o sqljdbc42.jar incluye el archivo "META-INF/services/java.sql.Driver", que contiene como controlador registrado el com.microsoft.sqlserver.jdbc.SQLServerDriver. Las aplicaciones existentes, que actualmente cargan los controladores usando el método Class.forName, seguirán trabajando sin modificación.

Nota:

La biblioteca de clases sqljdbc4.jar, sqljdbc41.jar o sqljdbc42.jar no se puede utilizar con versiones anteriores de Java Runtime Environment (JRE). Vea Requisitos del sistema para el controlador JDBC para obtener la lista de versiones de JRE compatibles con Microsoft JDBC Driver para SQL Server.

Para obtener más información sobre cómo conectar con orígenes de datos y usar una dirección URL de conexión, vea Creación de la dirección URL de conexión y Establecimiento de las propiedades de conexión.

Consulte también

Introducción al controlador JDBC