Использование JDBC Driver
В этом разделе приведены инструкции по созданию простого подключения к базе данных SQL Server с помощью драйвера Microsoft JDBC для SQL Server. Перед подключением к базе данных SQL Server необходимо сначала установить SQL Server на локальном компьютере или на сервере, а драйвер JDBC должен быть установлен на локальном компьютере.
Выбор нужного JAR-файла
Microsoft JDBC Driver обеспечивает различные Jar-файлы, которые можно использовать в соответствии с предпочитаемыми параметрами среды выполнения Java (JRE), как указано ниже.
Microsoft JDBC Driver 12.8 для SQL Server предоставляет файлы библиотеки классов mssql-jdbc-12.8.0.jre8.jar и mssql-jdbc-12.8.0.jre11.jar .
Microsoft JDBC Driver 12.6 для SQL Server предоставляет mssql-jdbc-12.6.0.jre8.jar и файлы библиотеки классов mssql-jdbc-12.6.0.jre11.jar .
Microsoft JDBC Driver 12.4 для SQL Server предоставляет файлы библиотеки классов mssql-jdbc-12.4.0.jre8.jar и mssql-jdbc-12.4.0.jre11.jar .
Microsoft JDBC Driver 12.2 для SQL Server предоставляет mssql-jdbc-12.2.0.jre8.jar и файлы библиотеки классов mssql-jdbc-12.2.0.jre11.jar .
Microsoft JDBC Driver 11.2 для SQL Server содержит следующие файлы библиотеки классов: mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar и mssql-jdbc-11.2.0.jre18.jar.
Microsoft JDBC Driver 10.2 для SQL Server содержит следующие файлы библиотеки классов: mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar и mssql-jdbc-10.2.0.jre17.jar.
Microsoft JDBC Driver 9.4 для SQL Server содержит следующие файлы библиотеки классов: mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar и mssql-jdbc-9.4.1.jre16.jar.
Microsoft JDBC Driver 9.2 для SQL Server содержит следующие файлы библиотеки классов: mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar и mssql-jdbc-9.2.1.jre15.jar.
Microsoft JDBC Driver 8.4 для SQL Server содержит следующие файлы библиотеки классов: mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar и mssql-jdbc-8.4.1.jre14.jar.
Microsoft JDBC Driver 8.2 для SQL Server содержит следующие файлы библиотеки классов: mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar и mssql-jdbc-8.2.2.jre13.jar.
Microsoft JDBC Driver 7.4 для SQL Server включает следующие файлы библиотеки классов: mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar и mssql-jdbc-7.4.1.jre12.jar.
Microsoft JDBC Driver 7.2 для SQL Server обеспечивает файлы библиотеки классов mssql-jdbc-7.2.2.jre8.jar и mssql-jdbc-7.2.2.jre11.jar.
Microsoft JDBC Driver 7.0 для SQL Server обеспечивает файлы библиотеки классов mssql-jdbc-7.0.0.jre8.jar и mssql-jdbc-7.0.0.jre10.jar.
Microsoft JDBC Driver 6.4 для SQL Server обеспечивает файлы библиотеки классов mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar и mssql-jdbc-6.4.0.jre9.jar.
Microsoft JDBC Driver 6.2 для SQL Server обеспечивает файлы библиотеки классов mssql-jdbc-6.2.2.jre7.jar и mssql-jdbc-6.2.2.jre8.jar.
Microsoft JDBC Driver 6.0 и 4.2 для SQL Server обеспечивают файлы библиотеки классов sqljdbc41.jar и sqljdbc42.jar.
Microsoft JDBC Driver 4.1 для SQL Server обеспечивает файл библиотеки класса sqljdbc41.jar.
От выбора версии драйвера зависит набор доступных функций. Дополнительные сведения о выборе JAR-файла см. в описании требований к системе для JDBC Driver.
Настройка пути к классу
JAR-файлы Microsoft JDBC Driver не являются частью Java SDK и должны быть включены в путь к классу пользовательского приложения.
Если используется JDBC Driver 12.8, задайте путь к классу , чтобы включить mssql-jdbc-12.8.0.jre8.jar или mssql-jdbc-12.8.0.jre11.jar.
Если используется JDBC Driver 12.6, задайте путь к классу , чтобы включить mssql-jdbc-12.6.0.jre8.jar или mssql-jdbc-12.6.0.jre11.jar.
Если используется JDBC Driver 12.4, задайте путь к классу , чтобы включить mssql-jdbc-12.4.0.jre8.jar или mssql-jdbc-12.4.0.jre11.jar.
Если используется JDBC Driver 12.2, задайте путь к классу , чтобы включить mssql-jdbc-12.2.0.jre8.jar или mssql-jdbc-12.2.0.jre11.jar.
Если используется JDBC Driver 11.2, настройте путь к классу, чтобы включить следующие файлы: mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar или mssql-jdbc-11.2.0.jre18.jar.
Если используется JDBC Driver 10.2, настройте путь к классу, чтобы включить следующие файлы: mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar или mssql-jdbc-10.2.0.jre17.jar.
Если используется JDBC Driver 9.4, настройте путь к классу, чтобы включить следующие файлы: mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar или mssql-jdbc-9.4.1.jre16.jar.
Если используется JDBC Driver 9.2, настройте путь к классу, чтобы включить следующие файлы: mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar или mssql-jdbc-9.2.1.jre15.jar.
Если используется JDBC Driver 8.4, настройте путь к классу, чтобы включить следующие файлы: mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar или mssql-jdbc-8.4.1.jre14.jar.
Если используется JDBC Driver 8.2, настройте путь к классу, чтобы включить следующие файлы: mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar или mssql-jdbc-8.2.2.jre13.jar.
Если используется JDBC Driver 7.4, настройте путь к классу, чтобы включить следующие файлы: mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar или mssql-jdbc-7.4.1.jre12.jar.
Если используется JDBC Driver 7.2, настройте путь к классу, чтобы включить файл mssql-jdbc-7.2.2.jre8.jar или mssql-jdbc-7.2.2.jre11.jar.
Если используется JDBC Driver 7.0, настройте путь к классу, чтобы включить файл mssql-jdbc-7.0.0.jre8.jar или mssql-jdbc-7.0.0.jre10.jar.
Если используется JDBC Driver 6.4, настройте путь к классу, чтобы включить следующие файлы: mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar или mssql-jdbc-6.4.0.jre9.jar.
Если используется JDBC Driver 6.2, настройте путь к классу, чтобы включить файл mssql-jdbc-6.2.2.jre7.jar или mssql-jdbc-6.2.2.jre8.jar.
Если используется JDBC Driver 4.1 или 4.2, настройте путь к классу, чтобы включить файл из соответствующей загрузки драйвера sqljdbc41.jar или sqljdbc42.jar.
Если в пути к классу отсутствует запись для правильного Jar-файла, приложение выдает общее исключение Class not found.
Для Microsoft JDBC Driver 12.8
Файлы mssql-jdbc-12.8.0.jre8.jar или mssql-jdbc-12.8.0.jre11.jar устанавливаются в следующих расположениях:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.8 for SQL Server\sqljdbc_12.8\enu\mssql-jdbc-12.8.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.8/enu/mssql-jdbc-12.8.0.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-12.8.0.jre8.jar, mssql-jdbc-12.8.0.jre11.jar.
Для Microsoft JDBC Driver 12.6
Файлы mssql-jdbc-12.6.0.jre8.jar или mssql-jdbc-12.6.0.jre11.jar устанавливаются в следующих расположениях:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.6 for SQL Server\sqljdbc_12.6\enu\mssql-jdbc-12.6.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.6/enu/mssql-jdbc-12.6.0.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-12.6.0.jre8.jar, mssql-jdbc-12.6.0.jre11.jar.
Для Microsoft JDBC Driver 12.4
Файлы mssql-jdbc-12.4.0.jre8.jar или mssql-jdbc-12.4.0.jre11.jar устанавливаются в следующих расположениях:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.4 for SQL Server\sqljdbc_12.4\enu\mssql-jdbc-12.4.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.4/enu/mssql-jdbc-12.4.0.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-12.4.0.jre8.jar, mssql-jdbc-12.4.0.jre11.jar.
Для Microsoft JDBC Driver 12.2
Файлы mssql-jdbc-12.2.0.jre8.jar или mssql-jdbc-12.2.0.jre11.jar устанавливаются в следующих расположениях:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.2 for SQL Server\sqljdbc_12.2\enu\mssql-jdbc-12.2.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.2/enu/mssql-jdbc-12.2.0.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-12.2.0.jre8.jar, mssql-jdbc-12.2.0.jre11.jar.
Для Microsoft JDBC Driver 11.2
Файлы mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar или mssql-jdbc-11.2.0.jre18.jar установлены в следующих расположениях:
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 11.2 for SQL Server\sqljdbc_11.2\enu\mssql-jdbc-11.2.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_11.2/enu/mssql-jdbc-11.2.0.jre11.jar
Убедитесь, что в инструкции CLASSPATH содержится только один драйвер Microsoft JDBC Driver для SQL Server, то есть mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar или mssql-jdbc-11.2.0.jre18.jar.
Для Microsoft JDBC Driver 10.2
Файлы mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar и mssql-jdbc-10.2.0.jre17.jar установлены в следующих расположениях:
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 10.2 for SQL Server\sqljdbc_10.2\enu\mssql-jdbc-10.2.0.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_10.2/enu/mssql-jdbc-10.2.0.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar или mssql-jdbc-10.2.0.jre17.jar.
Для Microsoft JDBC Driver 9.4
Файлы mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar или mssql-jdbc-9.4.1.jre16.jar установлены в следующих расположениях:
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.4 for SQL Server\sqljdbc_9.4\enu\mssql-jdbc-9.4.1.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.4/enu/mssql-jdbc-9.4.1.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar или mssql-jdbc-9.4.1.jre16.jar.
Для Microsoft JDBC Driver 9.2
Файлы mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar или mssql-jdbc-9.2.1.jre15.jar установлены в следующих расположениях:
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.2 for SQL Server\sqljdbc_9.2\enu\mssql-jdbc-9.2.1.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.2/enu/mssql-jdbc-9.2.1.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar или mssql-jdbc-9.2.1.jre15.jar.
Для Microsoft JDBC Driver 8.4
Файлы mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar или mssql-jdbc-8.4.1.jre14.jar установлены в следующих расположениях:
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.4 for SQL Server\sqljdbc_8.4\enu\mssql-jdbc-8.4.1.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.4/enu/mssql-jdbc-8.4.1.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar или mssql-jdbc-8.4.1.jre14.jar.
Для Microsoft JDBC Driver 8.2
Файлы mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar или mssql-jdbc-8.2.2.jre13.jar установлены в следующих расположениях:
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.2 for SQL Server\sqljdbc_8.2\enu\mssql-jdbc-8.2.2.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.2/enu/mssql-jdbc-8.2.2.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar или mssql-jdbc-8.2.2.jre13.jar.
Для Microsoft JDBC Driver 7.4
Файлы mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar или mssql-jdbc-7.4.1.jre12.jar установлены в следующих расположениях:
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.4 for SQL Server\sqljdbc_7.4\enu\mssql-jdbc-7.4.1.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar или mssql-jdbc-7.4.1.jre12.jar.
Для Microsoft JDBC Driver 7.2
Файлы mssql-jdbc-7.2.2.jre8.jar или mssql-jdbc-7.2.2.jre11.jar установлены в следующих местах.
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.2 for SQL Server\sqljdbc_7.2\enu\mssql-jdbc-7.2.2.jre11.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.2/enu/mssql-jdbc-7.2.2.jre11.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-7.2.2.jre8.jar или mssql-jdbc-7.2.2.jre11.jar.
Для Microsoft JDBC Driver 7.0
Файлы mssql-jdbc-7.0.0.jre8.jar или mssql-jdbc-7.0.0.jre10.jar установлены в следующих местах.
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre10.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.0 for SQL Server\sqljdbc_7.0\enu\mssql-jdbc-7.0.0.jre10.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.0/enu/mssql-jdbc-7.0.0.jre10.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-7.0.0.jre8.jar или mssql-jdbc-7.0.0.jre10.jar.
Для Microsoft JDBC Driver 6.4
Файлы mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar или mssql-jdbc-6.4.0.jre9.jar установлены в следующих местах.
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.4 for SQL Server\sqljdbc_6.4\enu\mssql-jdbc-6.4.0.jre9.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.4/enu/mssql-jdbc-6.4.0.jre9.jar
Убедитесь, что в инструкции CLASSPATH содержится только один драйвер Microsoft JDBC Driver для SQL Server, то есть mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar или mssql-jdbc-6.4.0.jre9.jar.
Для Microsoft JDBC Driver 6.2
Файлы mssql-jdbc-6.2.2.jre7.jar или mssql-jdbc-6.2.2.jre8.jar установлены в следующих местах.
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre7.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre8.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.2 for SQL Server\sqljdbc_6.2\enu\mssql-jdbc-6.2.2.jre8.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.2/enu/mssql-jdbc-6.2.2.jre8.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например mssql-jdbc-6.2.2.jre7.jar или mssql-jdbc-6.2.2.jre8.jar.
Для Microsoft JDBC Driver 4.1, 4.2 и 6.0
Файл sqljdbc.jar file, sqljdbc4.jar file, sqljdbc41.jar или sqljdbc42.jar устанавливается в следующее расположение:
\<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
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.0 for SQL Server\sqljdbc_4.2\enu\sqljdbc42.jar
В следующем фрагменте кода дан пример инструкции CLASSPATH, используемой для приложения Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.2/enu/sqljdbc42.jar
Убедитесь, что инструкция CLASSPATH содержит только один драйвер Microsoft JDBC для SQL Server, например sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar или sqljdbc42.jar.
Примечание.
В системах Windows имена каталогов, длина которых превышает оговоренный в соглашении об именовании размер 8.3, а также папки, имена которых содержат пробелы, могут вызвать проблемы с путями к классам. Если вы подозреваете такие проблемы, временно переместите файл sqljdbc.jar, sqljdbc4.jar или sqljdbc41.jar в каталог с простым именем, например C:\Temp, измените путь к классам и проверьте, устранило ли это проблему.
Приложения, которые выполняются непосредственно в командной строке
Путь к классам настраивается в операционной системе. Добавьте sqljdbc.jar, sqljdbc4.jar или sqljdbc41.jar в путь к классам в системе. Вы также можете указать путь к классам в командной строке Java при запуске приложения с помощью параметра java -classpath.
Приложения, выполняющиеся в интегрированной среде разработки
Каждый поставщик интегрированных сред разработки предоставляет собственный метод установки classpath. Простое задание пути к классам в операционной системе не будет работать. Необходимо добавить sqljdbc.jar, sqljdbc4.jar или sqljdbc41.jar в путь к классам интегрированной среды разработки.
Сервлеты и JSP
Сервлеты и JSP выполняются в подсистеме сервлетов/JSP, например Tomcat. Путь к классам должен быть задан в соответствии с документацией подсистемы сервлетов и JSP. Простое задание пути к классам в операционной системе не будет работать. Некоторые подсистемы сервлетов/JSP предоставляют экраны настройки, которые можно использовать для задания пути к классам подсистемы. В этом случае необходимо добавить к существующему пути к классу подсистемы нужный JAR-файл драйвера JDBC и перезапустить подсистему. В остальных случаях можно развернуть драйвер, скопировав файл sqljdbc.jar, sqljdbc4.jar или sqljdbc41.jar в определенный каталог (например, lib) во время установки подсистемы. Путь к классам драйвера подсистемы также можно задать в файле конфигурации конкретной подсистемы.
Enterprise Java Beans
Компоненты Enterprise Java Beans (EJB) выполняются в контейнере EJB. Контейнеры EJB предоставляются различными поставщиками. Java-приложения работают в браузере, но загружаются с веб-сервера. Скопируйте sqljdbc.jar, sqljdbc4.jar или sqljdbc41.jar в корень веб-сервера и укажите имя JAR-файла в параметре "archive" HTML-тега "applet", например: <applet ... archive=mssql-jdbc-***.jar>.
Установление простого подключения к базе данных
В случае использования библиотеки классов sqljdbc.jar приложение сначала должно зарегистрировать драйвер следующим образом:
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
После загрузки драйвера можно установить соединение с помощью URL-адреса соединения и метода getConnection класса DriverManager.
String connectionUrl = "jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=<password>;encrypt=false;";
Connection con = DriverManager.getConnection(connectionUrl);
Предупреждение
Приведенная выше строка подключения использует параметр encrypt=false, что не рекомендуется для рабочей среды. Дополнительные сведения о шифровании подключения к базе данных с помощью JDBC см. в статье Подключение с шифрованием.
Начиная с JDBC API 4.0 метод DriverManager.getConnection() усовершенствован и загружает драйверы JDBC автоматически. Поэтому при использовании библиотек JAR драйвера приложениям не обязательно вызывать метод Class.forName для регистрации или загрузки драйвера.
При вызове метода getConnection класса DriverManager подходящий драйвер выбирается из набора зарегистрированных драйверов JDBC. Файлы sqljdbc4.JAR, sqljdbc41.jar и sqljdbc42.jar содержат файл META-INF/services/java.sql.Driver, который содержит com.microsoft.sqlserver.jdbc.SQLServerDriver в качестве зарегистрированного драйвера. Существующие приложения, которые загружают драйверы с помощью метода Class.forName, продолжат работать, не требуя изменений.
Примечание.
Библиотеку классов sqljdbc4.JAR, sqljdbc41.jar или sqljdbc42.jar нельзя использовать с более старыми версиями среды выполнения Java. См . требования к системе для драйвера JDBC для списка версий JRE, поддерживаемых драйвером Microsoft JDBC для SQL Server.
Дополнительные сведения о подключении к источникам данных и использовании URL-адреса подключения см. в руководствах по созданию URL-адреса подключения и настройке свойств подключения.