Заметки о выпуске Microsoft JDBC Driver for SQL Server

Статья
08/29/2024

В этой статье перечислены выпуски Microsoft JDBC Driver для SQL Server . Для каждой версии выпуска названы и описаны изменения.

12,8

Скачайте драйвер Microsoft JDBC 12.8.1 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.8.1 для SQL Server (tar.gz)

Номер выпуска: 12.8.1
Выпущено: 22 августа 2024 г.

Соответствие 12.8

Изменение соответствий	Сведения
Скачайте последние обновления для JDBC Driver 12.8.	• GitHub, 12.8.0 • Maven Central
Полностью соответствует спецификации API JDBC версии 4.2.	Jars в пакете 12.8 называются в соответствии с совместимостью версий Java. Например, файл mssql-jdbc-12.8.0.jre11.jar из пакета 12.8 должен использоваться с Java 11 (или выше).
Совместим с пакетом разработки Java (JDK) версии 22.0, 21.0, 17.0, 11.0 и 1.8.	Microsoft JDBC Driver 12.8 для SQL Server теперь совместим с пакетом разработки Java (JDK) версии 22.0 в дополнение к JDK 21.0, 17.0, 11.0 и 1.8.

Выпуски 12.8

Номер выпуска: 12.8.1
Выпущено: 22 августа 2024 г.

Изменения в версии 12.8.1:

Изменено ведение журнала MSAL с FINER на FINEST

Исправлены проблемы в версии 12.8.1:

Скорректированные DESTINATION_COL_METADATA_LOCK в SQLServerBulkCopy, чтобы правильно выпускаться во всех случаях
Изменено поведение драйвера, позволяющее повторно использовать объекты подготовленной инструкции, предотвращая ошибку "несколько запросов не разрешено"
Отменяется функция "Выполнить хранимые процедуры напрямую" и последующие изменения, связанные с функцией.

Скачайте драйвер Microsoft JDBC 12.8.1 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.8.1 для SQL Server (tar.gz)

Номер выпуска: 12.8.0
Выпущено: 31 июля 2024 г.

Скачайте драйвер Microsoft JDBC 12.8.0 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.8.0 для SQL Server (tar.gz)

Новые возможности в версии 12.8

Функция	Подробности
Поддержка Java 22	Теперь драйвер совместим с пакетом средств разработки Java (JDK) версии 22.0 в дополнение к JDK 21.0, 17.0, 11.0 и 1.8.
Добавлен кэширование учетных данных при использовании учетных данных управляемого удостоверения или учетных данных Azure по умолчанию	Чтобы повысить производительность и надежность драйвера, драйвер теперь позволяет кэширование ранее упомянутых учетных данных.
Разрешить кэширование объекта при использовании массового копирования `SQLServerBulkCopy` для пакетной вставки	Заменяет предыдущее поведение, где каждый вызов созданного `executeBatch()` нового `SQLServerBulkCopy` объекта создается путем кэширования объекта.
Добавлено кэширование уровня подключения для метадата столбца назначения в массовом копировании	Повышает производительность путем добавления кэширования на уровне подключения для метаданных целевого столбца в сценариях массового копирования. Эта функция включена, задав для нового добавленного свойства `cacheBulkCopyMetadata` строка подключения значение `true` (значение `false`по умолчанию ).
Добавлен обработчик сообщений SQL Server и поддержка цепочек SQLException	Добавлен обработчик сообщений SQL Server, позволяющий использовать несколько функций, включая дополнительные отзывы для длительных запросов, универсального ведения журнала ошибок и автоматического понижения серьезности сообщений об ошибках от SQLException до SQLWarning. Кроме того, эта функция позволяет объединять sqlExceptions вместе, чтобы все сообщения об ошибках были доступны пользователю. См. дополнительные сведения об обработке ошибок.
Предоставлена полная поддержка RFC4180 для операций массового вставки CSV	Поддержка кавычек полей, содержащих новые линии, отсутствует, чтобы обеспечить полную поддержку с RFC4180; Теперь эта поддержка добавлена.
Разрешить создание экземпляра `microsoft.sql.DateTimeOffset` `java.time.OffsetDateTime` из значения	Преобразование между двумя типами данных уже существовало в драйвере с помощью посредника `Timestamp` . Это дополнение удаляет этот промежуточный элемент, повышая производительность и уменьшая вероятность ошибок, связанных с часовой поясом.

Изменения в версии 12.8

Изменение	Сведения
Перечисление `SQLServerSortOrder` теперь открыто	Изменена видимость перечисления на общедоступную, что позволяет пользователям больше гибкости `SQLServerSortOrder` в запросах, использующих эту перечисление.
Удаление `synchronized` из переопределения сокета	Неправильно добавлено в предыдущие изменения для подтверждения со стандартами проверки кода, методы выбора изменены не, на самом деле, должны быть синхронизированы и изменены, чтобы отразить этот факт.
Изменены предыдущие изменения RMERR/RMFAIL, выполнив изменения по умолчанию `RMFAIL`	Предыдущие изменения изменили значение `XAER_RMFAIL` `XAER_RMERR` для выборки случаев, однако эти случаи быстро стали наиболее охваченными. Решение состоит в том, чтобы изменить значение по умолчанию `RMFAIL` и преобразовать `RMERR` его в обратное из ранее указанных случаев.
Обновлены зависимости	Обновлены версии зависимостей для `azure-identity`, `bouncycastle`и `msal`.
Обновленная поддержка `TDSType.GUID`	Улучшает исходное добавление поддержки `TDSType.GUID` , позволяя прямой проход UUID в `setObject` метод.
Добавлено ведение журнала в кэширование маркеров	Добавлено больше ведения журнала для сценариев кэширования маркеров, которые помогут в сценариях отладки.

Исправления в версии 12.8

Fix	Сведения
Исправлена регрессия с указанием имен аргументов в синтаксисе вызываемой инструкции	Исправлена регрессия от 12.6.2 --> 12.6.3, в которой CallableStatements определенного формата возвращали неверные значения. Проблема GitHub #2477.
Исправлена синтаксический анализ для скобок в хранимых процедурах и функциях	Исправлена проблема, из-за которой вызов функции с круглыми скобками в конце вызываемой инструкции, например function() vs function(), в результате чего возвращаемое значение всегда равно 0. Это изменение было регрессией с 12.6.2 --> 12.6.3. Проблема GitHub #2463.
Исправлена ошибка, из-за которой драйвер не уважал `CallableStatement` аргументы по умолчанию.	Исправлена ошибка, которая была регрессией от 12.5.0 до> 12.6.0, где аргументы по умолчанию в вызываемых инструкциях игнорируются. Проблема GitHub #2446.
Исправление для удаления `TokenCredential` класса, для которого драйвер не требуется	`TokenCredentialClass`не требуется и `SQLServerSecurityUtility` может привести к неправильному возникновению.`NoClassDefFoundError` Это исправление удаляет импорт, заменив его универсальным `Object`. Проблема GitHub #2439.
Исправлена ошибка преобразования строк метки времени для CallableStatements	Исправлено исключение преобразования, которое произошло при вызове `DateTime` параметра in/out при задании `String` значения. Проблема GitHub #2436.
Исправлен конструктор SqlAuthenticationToken для принятия правильных параметров	Конструктор sqlAuthenticationToken был неверным, работая с входным параметром в секундах, когда он должен быть миллисекунд. Проблема GitHub #2424.
Исправление для очистки подготовленного дескриптора инструкций перед повторной подключением	Это устраняет проблему, из-за которой неправильные дескрипторы использовались после `SQLServerPreparedStatement` повторного подключения путем правильной очистки `SQLServerPreparedStatement.prepStmtHandle` перед повторным подключением. Проблема GitHub #2364.
Исправление для очистки подготовленного кэша инструкций при сбросе подключения к пулу инструкций	Это устраняет проблему, из-за которой при использовании пула инструкций повторное использование подключения из ConnectionPool привело к отсутствии или неправильно вставке записей. Проблема GitHub #2356.
Исправление для отмены привязки `socketTimeout` из `loginTimeout`	`socketTimeout` должен иметь верхнюю границу для создания подключения, но не должен иметь верхнюю границу `loginTimeout` после подключения драйвера. Это изменение исправляет это поведение. Проблема GitHub #2354.
Исправление, чтобы правильно проверить, имеет ли `TDSCommand` счетчик значение NULL перед попыткой увеличения	Добавляет недостающую `null` проверку счетчика `TDSCommand` , предотвращая `NullPointerException` , что в противном случае может возникнуть. Проблема GitHub #2353.
Исправление процедур вызова с выходными параметрами по их четырехкомпонентному синтаксису	Устранена проблема, из-за которой вызов хранимых процедур с четырехкомпонентным синтаксисом (т. е. с связанным сервером) приводил к ошибке с указанием недопустимого потока протокола TDS. Проблема GitHub #2344.
Исправление правильного экранирования `schema` параметров для `getProcedures` и `getProcedureColumns`	`SQLServerDatabaseMetadata` Методы `getProcedures` и `getProcedureColumns` не были должным образом экранирование определенных символов (например, `\`) для `schema` параметра. Это изменение исправляет эту проблему. Проблема GitHub #2336.
Добавлена карта кэша маркеров для исправления использования непреднамеренного маркера проверки подлинности для последующих подключений	Это устраняет проблему, из-за которой учетные данные клиента могут быть непреднамеренно использованы повторно. Хотя маркер проверки подлинности был правильно кэширован, драйвер повторно использовал маркер только с измененным секретом клиента. Проблема GitHub #2334.
Исправлена поддержка escape-синтаксиса `exec` в CallableStatements	Это устраняет проблему, из-за которой после удаления завернутых `sp_executesql`/`sp_prepexec` вызовов для быстрого выполнения callableStatements `EXEC` вызовы больше не работали. Проблема GitHub #2325.
Исправление, чтобы обеспечить `Money` и `SmallMoney` находятся в правильных диапазонах для массового копирования	Это устраняет проблему, из-за которой при использовании массового копирования с `Money` или `SmallMoney` значениями преобразование в значения могут привести к `ArithmeticOverflowException`возникновению проблемы. Проблема GitHub #2309.
Исправление, чтобы обеспечить `ResultSetMetadata` `DataabseMetadata.getColumns()` правильность всех столбцов	Возвращенные метаданные были неверны для некоторых столбцов, это изменение исправляет эту проблему. Проблема GitHub #2232.
Исправление для правильного отключения повторных попыток подключения при `connectRetryCount` установке `0`	Это исправляет поведение, в котором, даже если `connectRetryCount` задано значение 0, драйвер попытался повторить попытку до достижения `loginTimeout` . Проблема GitHub #2232. Проблема GitHub #2188.
Исправление `ClassLoader` для устранения утечки `ActivityCorrelator` `ThreadLocal`	Устранена проблема, из-за которой после изменения предыдущего драйвера `ActivityIdThreadLocal` в `ActivityCorrelator` потоке никогда не удаляется.
Исправление для выполнения хранимых процедур непосредственно для вызовов RPC	Вызовы RPC использовали предварительную логику путем упаковки в `sp_executesql` вызовы. Это изменение исправляет это поведение.

Предыдущие выпуски

12,6

Скачайте драйвер Microsoft JDBC 12.6.4 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.6.4 для SQL Server (tar.gz)

Номер выпуска: 12.6.4
Выпущено: 29 августа 2024 г.

Соответствие требованиям 12.6

Изменение соответствий	Сведения
Скачайте последние обновления для JDBC Driver 12.6.	• GitHub, 12.6.0 • Maven Central
Полностью соответствует спецификации API JDBC версии 4.2.	Jars в пакете 12.6 называются в соответствии с совместимостью версий Java. Например, файл mssql-jdbc-12.6.0.jre11.jar из пакета 12.6 должен использоваться с Java 11 (или выше).
Совместим с пакетом средств разработки Java (JDK) версии 21.0, 17.0, 11.0 и 1.8.	Microsoft JDBC Driver 12.6 для SQL Server теперь совместим с пакетом средств разработки Java (JDK) версии 21.0 в дополнение к JDK 17.0, 11.0 и 1.8.

Выпуски 12.6

Номер выпуска: 12.6.4
Выпущено: 29 августа 2024 г.

Исправлены проблемы в версии 12.6.4:

Отменяется функция "Выполнить хранимые процедуры напрямую" и последующие изменения, связанные с функцией.

Скачайте драйвер Microsoft JDBC 12.6.4 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.6.4 для SQL Server (tar.gz)

Номер выпуска: 12.6.3
Выпущено: 20 июня 2024 г.

Исправлены проблемы в версии 12.6.3:

Исправлена проблема, из-за которой необходимо импортировать класс TokenCredential
Исправлена регрессия преобразования строк метки времени
Исправлена регрессия значения по умолчанию SQLServerCallableStatement

Скачайте драйвер Microsoft JDBC 12.6.3 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.6.3 для SQL Server (tar.gz)

Номер выпуска: 12.6.2
Выпущено: 23 мая 2024 г.

Добавлены функции в версии 12.6.2:

Добавлена кэширование учетных данных для учетных данных управляемого удостоверения и учетных данных Azure по умолчанию

Исправлены проблемы в версии 12.6.2:

Проверьте, что деньги и небольшие деньги находятся в правильном диапазоне для массового копирования
Проверьте, имеет ли счетчик TDSCommand значение NULL перед увеличением
Очистка подготовленного кэша инструкций при сбросе подключения к пулу инструкций
Очистка дескриптора подготовленной инструкции перед повторной подключением
Вызовы RPC для CallableStatements выполняются напрямую
Исправленный объект маркера проверки подлинности для принятия срока действия в миллисекундах
SocketTimeout должен быть отключен при входе в loginTimeout после успешного открытия подключения

Скачайте драйвер Microsoft JDBC 12.6.2 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.6.2 для SQL Server (tar.gz)

Номер выпуска: 12.6.1
Выпущено: 20 февраля 2024 г.

Исправлены проблемы в версии 12.6.1:

Исправлен синтаксис escape-кода EXEC для CallableStatements

Скачайте драйвер Microsoft JDBC 12.6.1 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.6.1 для SQL Server (tar.gz)

Номер выпуска: 12.6.0
Выпущено: 31 января 2024 г.

Скачайте драйвер Microsoft JDBC 12.6.0 для SQL Server (zip)
Скачайте microsoft JDBC Driver 12.6.0 для SQL Server (tar.gz)

Новые возможности в версии 12.6

Функция	Подробности
Поддержка Java 21	Теперь драйвер совместим с пакетом средств разработки Java (JDK) версии 21.0 в дополнение к JDK 17.0, 11.0 и 1.8.
Разрешить вызов хранимых процедур непосредственно с помощью нового свойства подключения `useFlexibleCallableStatements`	Теперь драйвер вызывает процедуры хранения напрямую, а не обтекание процедурой, упрощение процедуры `exec sp_executesql`и повышение производительности.
Добавлено `useDefaultJaasConfig` свойство строка подключения	Если задано значение true, разрешает проверку подлинности Kerberos без дополнительной внешней конфигурации.
Добавлено `useDefaultGSSCredential` свойство строка подключения	Если задано значение true, драйвер может создавать GSSCredential от имени пользователя при использовании собственного GSS-API для проверки подлинности Kerberos.
Добавлено `calcBigDecimalPrecision` свойство строка подключения	Если задано значение true, драйвер позволяет вычислять точность входных данных BigDecimal.
Добавлены новые именованные средства ведения журнала для открытых повторных попыток подключения и отказоустойчивости подключения бездействия	Открытые повторные попытки подключения используют категорию ведения журнала перенаправления и могут использоваться на уровне ведения журнала FINE. Устойчивость бездействия подключения повторно подключается к категории ведения журнала устойчивости и может использоваться на уровнях ведения журнала FINE или FINER.

Изменения в версии 12.6

Изменение	Сведения
Изменен способ проверки IBM JDK на наличие проблем с средами OSGi	Изменено только на проверку имени поставщика, а также на проверку имени поставщика и виртуальной машины.
Правильно синхронизированы все вызовы MSAL	Запрещает водителю делать дополнительные звонки и доказывать ненужные диалоги.
Добавлены дополнительные ошибки, которые должны преобразовывать в RMFAIL	Добавлены дополнительные случаи, "сброс подключения по одноранговой системе" и "время ожидания подключения", которое должно быть равно RMFAIL
Изменение способа использования меток времени в массовом копировании	Измените поведение массового копирования с сериализации и десериализации объектов метки времени непосредственно на использование объектов, что приводит к улучшению производительности при использовании многих меток времени.
Изменено `socketTimeout` , чтобы убедиться, что оно правильно меньше, чем `loginTimeout`	Ранее действовал `socketTimeout` независимо от `loginTimeout` того, что может привести к потенциально запутанным поведением, где водитель займет больше времени ожидания, чем ожидалось. Эта проблема устранена, поэтому `socketTimeout` всегда имеет верхнюю границу, равной `loginTimeout`.
Отрегулировал кэш PreparedStatement, чтобы очистить себя перед каждым выполнением.	Кэш PreparedStatement не очищается правильно, что в дополнение к его редкости может привести к проблемам с памятью с течением времени. Это изменение гарантирует очистку кэша перед каждым выполнением, предотвращая сборку объектов.
Обновлено до новых зависимостей Bouncycastle	Обновление от `bcprov-jdk15on` и `bcpkix-jdk15on` `bcpkix-jdk18on` до `bcprov-jdk18on` того, как прежнее больше не обновляется.
Обновлены зависимости	Обновлены версии зависимостей для `azure-identity`, `azure-security-keyvault-keys`, `bouncycastle`, `h2` и `msal`.

Исправления в версии 12.6

Fix	Сведения
Исправлена недостающая проверка null для e.getCause()	Исправлена проблема, из-за которой, если исключение не имеет причин, само исключение передается вместе, предотвращая его потерю. Проблема GitHub #2299.
Исправлены блокировки в IOBuffer, чтобы предотвратить проблемы взаимоблокировки, которые могут возникнуть	Исправлена реализация блокировок в IOBuffer, в частности вокруг отключенияSSL, чтобы предотвратить взаимоблокировки, которые могут возникнуть в определенных ситуациях. Проблема GitHub #2288. Проблема GitHub #2265.
Исправлена проблема с метками времени и массовой копией для пакетной вставки	Исправлено неправильное применение часового пояса к меткам времени при вставке с помощью пакетной вставки с массовой копией. Проблема GitHub #2271.
Исправлены отсутствующие методы получения и задания для `useBulkCopyForBatchInsert`	Исправлена проблема, из-за которой поведение не было одинаковым между `SQLServerConnection` и `SQLServerConnnectionPoolProxy`, когда это должно быть, как `useBulkCopyForBatchInsert` и отсутствие метода получения и задания в последнем. Проблема GitHub #2245.
Исправлен запрос метаданных массового копирования для использования кэшированных данных, если он доступен	Исправлена проблема, из-за которой, несмотря на кэшируемые данные, вызовы метаданных столбца вызываются каждый раз. Проблема GitHub #2224.
Исправлена недостающая проверка масштаба BigDecimal для значений TVP	Исправлена проблема, из-за которой при написании значений строк TVP входные значения не были правильно отфильтрованы для масштабирования BigDecimal. Проблема GitHub #2222.
Исправлена схемаPattern в SQLServerDatabaseMetadata, чтобы обеспечить правильное использование параметра.	Исправлена проблема, из-за которой schemaPattern был единственным шаблоном, не соответствующим образом экранируемым в SQLServerDatabaseMetadata. Проблема GitHub #2186.
Исправлена проблема, из-за которой возвращалось значение NULL SQLState при попытке преобразовать дату в длину	Исправлена проблема, из-за которой, если `xopenStates` задано значение true, драйвер не возвращает ожидаемый код состояния SQL-99 в определенном экземпляре. Проблема GitHub #2167.
Исправлена ошибка getMetaData для запросов, содержащих TOP	Исправлена проблема, из-за которой при использовании квалификатора TOP в запросе драйвер возвращает ошибку, связанную с параметромMetadata. Проблема GitHub #1776.
Исправлена проблема синтаксического анализа имени таблицы при использовании пакетных вставок	Исправлена проблема, из-за которой инструкции вставки с отсутствующим пробелом работали правильно в обычных случаях, но не при использовании пакетных вставок. Проблема GitHub #1534.
Исправлена проблема с параметромMetadata и недопустимыми индексами	Исправлена проблема с неправильной проверкой параметровMetadata и создание исключений для недопустимого индекса 0. Проблема GitHub #1490.
Исправлено поведение ActivityID в ActivityCorrelator	Исправлен способ определения и использования ActivityID в соответствии с поведением других драйверов Майкрософт.
Исправление, чтобы игнорировать вычисляемые столбцы при использовании массового копирования для пакетной вставки	Исправлено поведение массового копирования, чтобы игнорировать вычисляемые столбцы и разрешить пакетные вставки, когда ранее вставка завершится ошибкой и возвращает ошибку со ссылкой на эти вычисляемые столбцы.
Исправлено поведение драйвера для подписей при использовании Хранилища ключей Java и Azure Key Vault	Исправлена проблема, из-за которой драйвер неправильно проверял подпись при использовании Хранилища ключей Java и добавлял новый API для подписи метаданных главного ключа столбца (и возвращал созданную подпись) для использования с Хранилищем ключей Java и Azure Key Vault.
Исправлено ошибочное преобразование DateTimeOffset getObject().	Исправлена проблема при вызове ResultSet.getObject() в столбце DATETIMEOFFSET с помощью LocalDate/LocalTime/LocalDateTime в качестве аргумента класса, значение в столбце будет преобразовано в локальный часовой пояс.

12,4

Скачать Microsoft JDBC Driver 12.4.2 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.4.2 для SQL Server (tar.gz)

Номер выпуска: 12.4.2
Выпущено: 27 октября 2023 г.

Соответствие требованиям 12.4

Изменение соответствий	Сведения
Скачайте последние обновления для JDBC Driver 12.4.	• GitHub, 12.4.0. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	Jars в пакете 12.4 называются в соответствии с совместимостью версий Java. Например, файл mssql-jdbc-12.4.0.jre11.jar из пакета 12.4 должен использоваться с Java 11 (или более поздней версии).
Совместим с пакетом разработки Java (JDK) версии 20.0, 17.0, 11.0 и 1.8.	Microsoft JDBC Driver 12.4 для SQL Server теперь совместим с пакетом средств разработки Java (JDK) версии 20.0 в дополнение к JDK 17.0, 11.0 и 1.8.

Выпуски 12.4

Номер выпуска: 12.4.2
Выпущено: 21 сентября 2023 г.

Исправлены проблемы в версии 12.4.2:

Отменена проверка IBM на проверку поставщика и добавлена дополнительная проверка имени виртуальной машины, чтобы удалить ложные срабатывания.

Скачать Microsoft JDBC Driver 12.4.2 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.4.2 для SQL Server (tar.gz)

Номер выпуска: 12.4.1
Выпущено: 24 августа 2023 г.

Изменения в версии 12.4.1:

Готовые имена параметров SQL теперь имеют автоматическое интервалирование

Исправлены проблемы в версии 12.4.1:

Исправлен запрос метаданных getUserName в олицетворенный контекст безопасности в базе данных SQL Azure
Исправлено обнаружение IBM JDK
Исправлена ошибка, из-за которой подпись не проверена для Хранилища ключей Java и добавление API signColumnMasterkeyMetadata в JKS и AKV
Добавлена локализация строк ошибок, отсутствующих в исходном выпуске

Скачайте драйвер Microsoft JDBC 12.4.1 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.4.1 для SQL Server (tar.gz)

Номер выпуска: 12.4.0
Выпущено: 31 июля 2023 г.

Скачайте драйвер Microsoft JDBC 12.4.0 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.4.0 для SQL Server (tar.gz)

Новые возможности в версии 12.4

Функция	Подробности
Поддержка Java 20	Теперь драйвер совместим с пакетом средств разработки Java (JDK) версии 20.0, а также JDK 17.0, 11.0 и 1.8.
Добавлено свойство обратного вызова маркера доступа строка подключения	Дополняет ранее реализованный обратный вызов маркера доступа, позволяя передавать имя класса обратного вызова в строка подключения.
Добавлена поддержка ActiveDirectoryServicePrincipalCertificate	Улучшение взаимодействия с пользователем путем поддержки `ActiveDirectoryServicePrincipalCertificate` библиотеки удостоверений Azure с помощью параметра `authentication=ActiveDirectoryServicePrincipalCertificate`подключения.
Добавлен еще один случай для XAER_RMFAIL	Драйвер по-прежнему возвращает XAException с ошибкой XAER_RMERR в некоторых случаях. Дополнительный случай был добавлен в обработку ошибок XA для решения этой проблемы.

Изменения в версии 12.4

Изменение	Сведения
Обновлена федеративная логика проверки подлинности для использования кэша сохраняемых маркеров при получении маркера	Это обновление повышает производительность в сценариях получения маркеров и упрощает совместимость с будущими версиями MSAL.
Разрешить попытку партнера по отработке отказа, если время ожидания сокета	Разрешает попытку повторного подключения с предоставленным партнером отработки отказа после истечения времени ожидания сокета.
Улучшенная производительность при создании определений типов параметров	Путем предварительной компиляции размеров массивов и построителей строк, используемых в `buildParamTypeDefinitions`, а также путем удаления ненужных выделений строк, повышение производительности, в которой используется этот метод.
Измененное имя сервера, отправленное в `LOGIN` пакет, чтобы включить имя экземпляра	`serverName` теперь добавляется в конец `instanceName` `LOGIN` пакетов.
Обновленный метод supportTransaction, который отражает, поддерживает ли сервер транзакции.	Устранена проблема, из-за которой `connection.rollback` не работала база данных Azure Synapse, так как Azure Synapse не поддерживает синтаксис, используемый в `supportTransaction`.
Обновление вызовов sp_cursor таким образом, чтобы имена таблиц передаются вместо пустой строки	Устранена проблема, из-за которой несогласованные обновления строк ResultSet были получены при обновлении таблиц "один ко многим".
Обновлена поддержкаLikeEscapeClause() для проверки наличия хранилища данных Azure	Устранена проблема, из-за которой `supportsLikeEscapeClause` возвращалось значение true для AzureDW, несмотря на то, что она явно не поддерживается.
Обновлена до последней спецификации OSGi JDBC	Обновление с `osgi.compendium` версии 5.0.0 до `osgi.service.jdbc` версии 1.1.0 для обеспечения соответствия спецификации OSGi JDBC 8.1.0.
Обновлены зависимости	Обновлены версии зависимостей для `azure-identity`, `azure-security-keyvault-keys`, `gson`, `h2` и `msal`.

Исправления в версии 12.4

Fix	Сведения
Исправлены проблемы с производительностью и памятью, возникающие при работе с BigDecimal	Отменяет все изменения, начиная с выпуска 12.2, относительно BigDecimal. Это устраняет проблемы с производительностью, которые наблюдались. Пользователи должны заботиться об использовании BigDecimal, чтобы избежать проблем усечения, которые были устранены ранее. Проблема GitHub #2176.
Исправлена проверка сертификата сервера для encrypt=strict	Исправление, чтобы убедиться, что сертификат сервера правильно проверен в случаях, когда `encrypt` задано значение `strict`. Проблема GitHub #2174.
Исправлена блокировкаTimeout, не включаемая при настройке режима перенаправления в Базе данных Azure	Исправлено, если `lockTimeout` задано значение, так как оно должно применяться только к подключениям извне Azure, а не из Azure, как было ранее. Проблема GitHub #2110.
Исправлено большое число потоков при использовании findSocketUsingThreading	Устранена проблема, из-за которой неуловимое исключение привело к прерыванию вызовов сна вышестоящей передачи, что приводит к слишком быстрому повторам. Проблема GitHub #2104.
Исправлено состояние гонки общего таймера	Исправлено потенциальное состояние гонки в `SharedTimer` классе. Проблема GitHub #2085.
Исправлена ошибка с хранимыми процедурами и нулевой возврат результата `metaQuery`	Исправлена проблема, из-за которой, если `metaQuery` после выполнения хранимой процедуры не возвращался результат, эта проблема вернет неопределенную ошибку параметра. Проблема GitHub #2063.
Исправлена недопустимая пакетная вставка, если столбцы, предоставленные в вставке, отличаются по порядку от схемы таблицы.	Исправлена проблема, из-за которой использование может привести к перемешиствию столбцов `useBulkCopyForBatchInsert=true` и недопустимым данным. Проблема GitHub #1992.
Исправлена обработка ошибок XA для повторного увеличения XAER_RMFAIL вместо XAER_RMERR	Исправлена проблема, из-за которой драйвер вернет XAException с кодом ошибки XAER_RMERR, если произошел отработка отказа SQL Server с первичного узла на резервный узел при фиксации транзакции XA. Проблема GitHub #1432.
Исправлено поведение идентификатора действия и идентификатора клиента для обеспечения согласованности с спецификацией JDBC	Исправлено поведение идентификатора действия, которое должно оставаться неизменным в течение всего процесса, всегда отправлять идентификатор действия и `PRELOGIN`добавочную последовательность для каждого нового подключения. Также исправлен идентификатор клиента, сохраняемый в течение срока действия процесса.

12,2

Скачать Microsoft JDBC Driver 12.2.0 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.2.0 для SQL Server (tar.gz)

Номер выпуска: 12.2.0
Выпущено: 31 января 2023 г.

Соответствие требованиям 12.2

Изменение соответствий	Сведения
Скачайте последние обновления для JDBC Driver 12.2.	• GitHub, 12.2.0. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	Jars в пакете 12.2 называются в соответствии с совместимостью версий Java. Например, файл mssql-jdbc-12.2.0.jre11.jar из пакета 12.2 должен использоваться с Java 11 (или более поздней версии).
Совместим с пакетом средств разработки Java (JDK) версии 19.0, 17.0, 11.0 и 1.8.	Microsoft JDBC Driver 12.2 для SQL Server теперь совместим с пакетом средств разработки Java (JDK) версии 19.0 в дополнение к JDK 17.0, 11.0 и 1.8.

Выпуски 12.2

Скачать Microsoft JDBC Driver 12.2.0 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 12.2.0 для SQL Server (tar.gz)

Номер выпуска: 12.2.0
Выпущено: 31 января 2023 г.

Новые возможности в версии 12.2

Функция	Подробности
Поддержка Java 19	Теперь драйвер совместим с пакетом средств разработки Java (JDK) версии 19.0 в дополнение к JDK 17.0, 11.0 и 1.8.
Добавлена поддержка обратного вызова маркера доступа	Позволяет клиентскому коду регистрировать обратный вызов в DataSource, который возвращает маркер доступа.
Добавлена поддержка DefaultAzureCredential	Улучшение взаимодействия с пользователем путем поддержки как `DefaultAzureCredential` библиотеки удостоверений Azure, так и `IntelliJCredential` из библиотеки удостоверений Azure с помощью параметра `authentication=ActiveDirectoryDefault`подключения.
Добавлено новое свойство подключения datetimeParameterType для указания типа данных, используемого для параметров метки даты и времени.	Добавлено свойство `datetimeParameterType`подключения, позволяющее пользователям явно указывать преобразования `datetime` в старые базы данных или `datetime2`обеспечивать большую совместимость.

Изменения в версии 12.2

Изменение	Сведения
Сделано драйвер loom-friendly	`synchronized(foo)` Заменяет повторную блокировку, повышая производительность при использовании Loom.
Проверка подлинности управляемого удостоверения использует библиотеку удостоверений Azure	Заменяет встроенный код драйвера для получения и кэширования маркеров управляемого удостоверения библиотекой удостоверений Azure. Это изменение добавляет поддержку управляемого удостоверения для дополнительных служб Azure по сравнению с ранее поддерживаемым драйвером.
Сделать MSAL необязательным зависимостем	Снова сделал msal4j необязательным зависимостем.
Обновлены зависимости	Обновлены версии зависимостей для `azure-identity`, , `azure-security-keyvault-keys`, `antlr4-runtime`и `bcpkix-jdk15onbcprov-jdk15onmsal`.
Обновление для динамического проверки класса ExtendedSocketOption	Устраняет ошибку, в которой отсутствует ExtendedSocketOptions, возвращаемой `NoClassDefFoundError`.

Исправления в версии 12.2

Fix	Сведения
Исправлено состояние NULL SQL и нулевой код ошибки при возникновении исключения базы данных	Исправлена проблема, из-за которой после ошибки SQL состояние SQL и код ошибки показали неверные сведения. Проблема GitHub #2015.
Исправлено восстановление подключения бездействия, чтобы `unprocessedResponseCount` не было чрезмерно отложено	`unprocessedResponseCount` необходимо только уменьшать, когда `doneToken.isFinal` это верно, он уменьшается независимо от того, что он уменьшается. Проблема GitHub #1971.
Исправлено подключение к неправильному узлу SQLServer	Устраняет проблему параллелизма, когда драйвер подключается к нескольким узлам SQLServer, может быть установлено подключение к неправильному узлу. Проблема GitHub #1964.
Исправлено неправильно `updateCount`	Неверное число обновлений может произойти как в истинных, так и в ложных случаях для `enablePrepareOnFirstPreparedStatementCall` обоих препексе или подготовки. Проблема GitHub #1961.
Исправлены проблемы с параллелизмом в методах шифрования и расшифровки маскировки для пароля truststore	Добавлены блокировки для шифрования и расшифровки пароля в truststore password obfuscation. Проблема GitHub #1939.
Исправлена проблема с регистром имени учетной записи кэша	Устранена проблема, из-за которой имена учетных записей были отправлены в библиотеку проверки подлинности Майкрософт с учетом регистра, что привело к повторным запросам на вход. Проблема GitHub #1923.
Исправлена ошибка отмены запроса	Исправлена ошибка отмены запросов, которая периодически возникает в пакетных запросах. Проблема GitHub #1896.
Исправлены ошибки вызываемой инструкции	Исправляет вызываемую инструкцию "индекс из границ" и "параметр не определен" ошибок. Проблема GitHub #1871.
Исправлена проверка маркера DONE при получении результирующих наборов	Добавляет пропущенный случай в предыдущее исправление DONE_ERROR, где драйвер проигнорировал состояние DONE_ERROR с сервера, полученного из убитого сеанса. Проблема GitHub #1846. Проблема GitHub #1505.
Убедитесь, что batchParamValues очищается во всех случаях при выполнении пакета	Устранена проблема, из-за которой пакеты не были должным образом очищаются при использовании массового обновления. Проблема GitHub #1767.
Исправлена точность, отправляемая при использовании BigDecimal	Исправлена проблема, из-за которой, по умолчанию, значения BigDecimal были отправлены с максимальной точностью, что может привести к отмене округления десятичных знаков. Проблема GitHub #1489. Проблема GitHub #942
Исправлен протокол `NONE` аттестации для работы во всех случаях	Исправлена логика за `NONE` протоколом аттестации для работы во всех случаях, а не только для конкретных.
Исправлено состояние гонки в SecureStringUtil	Исправлено условие гонки в SecureStringUtil во время создания SecureStringUtil.

11.2

Скачайте драйвер Microsoft JDBC 11.2.3 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 11.2.3 для SQL Server (tar.gz)

Номер выпуска: 11.2.3
Выпущено: 12 января 2023 г.

Соответствие требованиям в версии 11.2

Изменение соответствий	Сведения
Скачайте последние обновления для драйвера JDBC версии 11.2.	• GitHub, 11.2.0. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	JAR-файлам в пакете 11.2 имена присваиваются с учетом совместимости версий Java. Например, файл mssql-jdbc-11.20.jre17.jar из пакета 11.2 должен использоваться с Java 17.
Совместимость с пакетом Java Development Kit (JDK) версий 18.0, 17.0, 11.0 и 1.8.	Microsoft JDBC Driver 11.2 for SQL Server теперь совместим с пакетом Java Development Kit (JDK) версии 18.0, помимо версий 17.0, 11.0 и 1.8.

Выпуски версии 11.2

Номер выпуска: 11.2.3
Выпущено: 12 января 2023 г.

Исправлены проблемы в версии 11.2.3:

Исправлено состояние NULL SQL и нулевой код ошибки при возникновении исключения базы данных
Исправлено неправильное количество обновлений при возникновении времени ожидания в пакетных запросах
Исправлена неправильная дата окончания срока действия маркера при использовании Функции Azure
Исправлено подключение к неправильному узлу SQLServer

Номер выпуска: 11.2.2
Выпущено: 15 декабря 2022 г.

Исправлены проблемы в версии 11.2.2.

Исправлена ошибка устойчивости подключения бездействия
Очистка подготовленного кэша инструкций при повторном подключении бездействия
Исправлена ошибка вызываемого индекса инструкции вне границ
Исправлена проверка маркера DONE при получении результирующих наборов
Исправлена прерывистая ошибка: "Внутренняя ошибка во время расшифровки: несоответствие тегов!"

Скачайте драйвер Microsoft JDBC 11.2.2 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 11.2.2 для SQL Server (tar.gz)

Номер выпуска: 11.2.1
Выпущено: 8 сентября 2022 г.

Исправлены проблемы в версии 11.2.1:

Создание com.microsoft.azure:msal4j необязательной зависимости
Исправлена ошибка отмены запроса, которая периодически возникала в пакетных запросах

Скачайте драйвер Microsoft JDBC 11.2.1 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 11.2.1 для SQL Server (tar.gz)

Номер выпуска: 11.2.0
Дата выпуска: 4 августа 2022 г.

Скачать Microsoft JDBC Driver 11.2.0 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 11.2.0 для SQL Server (TAR.GZ)

Новые возможности в версии 11.2

Функция	Подробности
Поддержка Java 18	Теперь драйвер совместим с пакетом Java Development Kit (JDK) версии 18.0 в дополнение к версиям 17.0, 11.0 и 1.8.
Добавлена настраиваемая поддержка IPv6-адресов	Теперь для клиентского приложения можно назначить приоритет IPv4- или IPv6-адресам. Для управления поведением используйте новый параметр подключения `ipaddresspreference`. Дополнительные сведения см. в статье о настройке свойств подключения.
Добавлена поддержка выбора метода подготовки	Добавлено новое свойство строки подключения prepareMethod для переключения между sp_prepare и sp_prepexec. Для управления поведением используйте новый параметр подключения `prepareMethod`. Дополнительные сведения см. в статье о настройке свойств подключения.
Добавлено свойство подключения serverCertificate для encrypt=strict	Добавлено свойство serverCertificate, которое является путем к файлу сертификата сервера (в формате PEM). Используется для проверки, если для параметра encrypt задано значения strict. Дополнительные сведения см. в статье о настройке свойств подключения.
Вызовы метаданных параметров кэша	Теперь можно кэшировать сведения, связанные с шифрованием, для параметризованных запросов. См. Использование функции Always Encrypted с драйвером JDBC
Добавлена поддержка массового вставки значений GUID NULL	Устранена проблема, из-за которой вставка значений NULL невозможна в режиме массовой вставки.
Добавлена поддержка кэширования маркеров управляемого удостоверения	Разрешить кэширование маркеров, полученных из конечных точек управляемого удостоверения.

Изменения в версии 11.2

Изменение	Сведения
Поддержка TDS 8.0 за счет добавления варианта strict в свойство шифрования подключения	КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ. Свойство шифрования подключения теперь имеет строковый тип.
Добавлена проверка согласованного ALPN	Проверяется, успешно ли согласован протокол прикладного уровня.
Добавлен параметр для enclaveAttestationProtocol	Добавлен параметр для протокола `NONE`, позволяющий использовать безопасные анклавы без аттестации.
Разрешить переупорядочение имени сервера в строка подключения	Убедитесь, что поле serverName строка подключения не имеет знака равенства.
Добавлено улучшенное ведение журнала ошибок для отсутствующих библиотек MSAL	Добавлено сообщение об ошибке при отсутствии MSAL при использовании `ActiveDirectoryServicePrincipal`.
Рефакторинг времени ожидания устойчивости подключения рефакторинг для использования существующего SharedTimer	Улучшена эффективность работы с устойчивостью подключения бездействия с помощью существующего SharedTimer.
Отправка TDS версии 8 в Login7 в строгом режиме	Добавлена дополнительная информация в пакет Login7, включая TDS версии 8 при шифровании=strict.
Изменено значение loginTimeout по умолчанию на 30s	Измените значение loginTimeout по умолчанию с 15 секунд на 30 секунд, чтобы разрешить больше времени для разрешения начальных подключений до истечения времени ожидания.
Зависимость `msal4j` теперь является явной	Добавлена явная зависимость для `msal4j` (в предыдущих выпусках это была транзитивная зависимость).
Обновлены зависимости	Обновлены версии зависимостей для `azure-identity` и `azure-security-keyvault-keys`.

Исправления в версии 11.2

Fix	Сведения
Исправлена ошибка, вызванная подготовленнойMethod=prepare	Исправлена прерывистая обработка подготовленной инструкции NULL, вызванная ошибкой sp_prepare при использовании с пакетными запросами GitHub Issue #1880.
Исправлена ошибка, при которой параллельное создание нескольких подключений может вызвать исключение IndexOutOfBoundsException	Исправлено состояние гонки с адресным списком, которое может привести к индексуOutOfBoundsException при установке нескольких подключений GitHub Issue #1852.
Исправлена ошибка утверждения, которая происходит при отмене инструкции insert into	Исправлена проблема, из-за которой драйвер может утверждать при отмене инструкции GitHub Issue #1849.
Исправлено исключение, не вызываемое должным образом при убийстве сеанса в базе данных SQL	Добавлена проверка DONE_ERROR маркера состояния, который может произойти из убитого сеанса на сервере GitHub Issue #1846.
Интервал повторных попыток для управляемого удостоверения	Исправлен интервал повторных попыток управляемого удостоверения для правильного выполнения экспоненциальной задержки. Проблема GitHub № 1765
Удален дополнительный вызов для выполненияCommand() в connectionCommand()	Удален дополнительный вызов для выполненияCommand, который вызвал проблемы с производительностью для некоторых пользователей GitHub Issue #1669.
Исправлена ошибка неизвестного маркера с помощью selectMethod	Исправлена ошибка `0xA3` неизвестного маркера при `selectMethod` использовании курсора с классификацией данных.

10.2

Скачайте драйвер Microsoft JDBC 10.2.3 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 10.2.3 для SQL Server (tar.gz)

Номер выпуска: 10.2.3
Выпущено: 12 января 2023 г.

Номер выпуска: 10.2.2
Выпущено: 13 декабря 2022 г.

Скачайте драйвер Microsoft JDBC 10.2.2 для SQL Server (zip)
Скачайте драйвер Microsoft JDBC 10.2.2 для SQL Server (tar.gz)

Номер выпуска: 10.2.1
Дата выпуска: 12 мая 2022 г.

Скачать Microsoft JDBC Driver 10.2.1 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 10.2.1 для SQL Server (TAR.GZ)

Соответствие требованиям в версии 10.2

Изменение соответствий	Сведения
Скачайте последние обновления для драйвера JDBC версии 10.2.	• GitHub, 10.2.0. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	JAR-файлам в пакете 10.2 имена присваиваются с учетом совместимости версий Java. Например, файл mssql-jdbc-10.20.jre17.jar из пакета 10.2 должен использоваться с Java 17.
Совместимость с пакетом Java Development Kit (JDK) версий 17.0, 11.0 и 1.8.	Microsoft JDBC Driver 10.2 для SQL Server теперь совместим с пакетом Java Development Kit (JDK) версии 17.0, помимо версий 11.0 и 1.8.

Выпуски версии 10.2

Номер выпуска: 10.2.3
Выпущено: 12 января 2023 г.

Исправлены проблемы в версии 10.2.3:

Исправлено неправильное количество обновлений при возникновении времени ожидания в пакетных запросах
Исправлена неправильная дата окончания срока действия маркера при использовании Функции Azure
Исправлено состояние NULL SQL и нулевой код ошибки при возникновении исключения базы данных

Номер выпуска: 10.2.2
Выпущено: 13 декабря 2022 г.

Исправлены проблемы в версии 10.2.2.

Очистка кэша подготовленных инструкций при повторном подключении к неактивным подключениям
Исправление для настройки расширенных параметров KeepAlive
Исправлена проблема, из-за которой драйвер может утверждать при отмене инструкции
Исправлена ошибка вызываемого индекса инструкции вне границ
Исправлена проблема без проверки ошибок маркера ГОТОВО, поэтому исключения игнорируются
Исправлена ошибка отмены запроса

Номер выпуска: 10.2.1
Дата выпуска: 12 мая 2022 г.

Устраненные проблемы в версии 10.2.1:

Изменено время ожидания для устойчивости бездействующих подключений для использования существующего SharedTimer.
Исправлен интервал повторных попыток проверки подлинности управляемого удостоверения для правильного выполнения экспоненциальной отсрочки.
Удален ненужный вызов executeCommand() в connectionCommand().

Номер выпуска: 10.2.0
Дата выпуска: 31 января 2022 г.

Скачать Microsoft JDBC Driver 10.2.0 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 10.2.0 для SQL Server (TAR.GZ)

Новые возможности в версии 10.2

Функция	Подробности
Поддержка Java 17	Теперь драйвер совместим с пакетом Java Development Kit (JDK) версии 17.0 в дополнение к версиям 11.0 и 1.8.
Поддержка устойчивости неактивного подключения	Теперь поддерживается устойчивость неактивного подключения. См. Устойчивость неактивного подключения.
Поставщики хранилища ключей для нескольких пользователей	Теперь драйвер поддерживает поставщиков хранилища ключей на уровне подключения и инструкции для поддержки сценариев с несколькими пользователями. См. Использование функции Always Encrypted с драйвером JDBC

Изменения в версии 10.2

Изменение	Сведения
Значение "true" по умолчанию для параметра encrypt	Критическое изменение Шифрование TLS включено по умолчанию.
Проверка сертификата при заданном значении "false" для параметра encrypt	КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ при шифровании = false, но сервер требует шифрования, сертификат проверяется на основе параметра подключения trustServerCertificate.
Больше не рекомендуются aadSecurePrincipalId и aadSecurePrincipalSecret	Свойства подключения aadSecurePrincipalId и aadSecurePrincipalSecret устарели. Вместо них используйте имя пользователя и пароль.
Удален API getAADSecretPrincipalId	КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ . API getAADSecretPrincipalId удаляется по соображениям безопасности.
Поддержка SQL_Variant	Добавлена поддержка типа данных SQL_Variant при получении DateTimeOffset.
Неблокирование случайных значений в Linux	Обновлено, чтобы использовать случайный вызов без блокировки при создании GUID для пакетов анклава.
Разрешение CNAME для области определения приложения	Добавлено разрешение CNAME при указании области определения приложения.
Обновлены зависимости	Обновлены версии зависимостей для `azure-identity`, `azure-security-keyvault-keys`, `gson` и `bouncycastle`.

Исправления в версии 10.2

Fix	Сведения
TDSParser приостанавливался на TDS_COLMETADATA	Исправлено: TDSParser приостанавливался на TDS_COLMETADATA, что в определенных запросах могло привести к зависанию. Проблема GitHub 1661

9,4

Скачать Microsoft JDBC Driver 9.4.1 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 9.4.1 для SQL Server (TAR.GZ)

Номер выпуска: 9.4.1
Дата выпуска: 7 декабря 2021 г.

Соответствие требованиям в версии 9.4

Изменение соответствий	Сведения
Скачайте последние обновления для драйвера JDBC версии 9.4.	• GitHub, 9.4.0. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	JAR-файлам в пакете 9.4 имена присваиваются с учетом совместимости версий Java. Например, файл mssql-jdbc-9.4.0.jre16.jar из пакета 9.4 должен использоваться с Java 16.
Совместимость с пакетом Java Development Kit (JDK) версий 16.0, 11.0 и 1.8.	Microsoft JDBC Driver for SQL Server версии 9.4 теперь совместим с пакетом Java Development Kit (JDK) версии 16.0 наряду с JDK версий 11.0 и 1.8.

Выпуски версии 9.4

Номер версии: 9.4.1
Дата выпуска: 7 декабря 2021 г.

Устраненные проблемы в версии 9.4.1:

Исправлена потенциальная зависание, когда драйвер сталкивается с неподдерживаемой TDS_COLMETADATA
Исправлено преобразование LocalDateTime и LocalTime в строку при операции с массового копирования.

Номер версии: 9.4.0
Дата выпуска: 30 июля 2021 г.

Скачать Microsoft JDBC Driver 9.4.0 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 9.4.0 для SQL Server (TAR.GZ)

Новые возможности в версии 9.4

Функция	Подробности
Поддержка Java 16	Теперь драйвер совместим с пакетом Java Development Kit (JDK) версии 16.0 в дополнение к JDK версии 11.0 и 1.8.
Поддержка подключений репликации	Теперь поддерживаются подключения репликации. См. раздел Настройка свойств подключения.
Настраиваемая область проверки подлинности Kerberos	Теперь драйвер поддерживает указание настраиваемой области проверки подлинности при использовании проверки подлинности Kerberos. См. раздел Настройка свойств подключения.
Повторные попытки при открытии подключения	Свойства `connectRetryCount` подключения `connectRetryInterval` добавляются для настройки автоматических повторных попыток при открытии подключений. Дополнительные сведения об этих новых свойствах см. в разделе Настройка свойств подключения.

Изменения в версии 9.4

Изменение	Сведения
Поставщик Azure Key Vault	Может быть открыто несколько последовательных успешных подключений, в которых указаны различные сведения о поставщике Azure Key Vault.
Обновлены сообщения об ошибках	Сообщения об ошибках, связанные с исключениями анклава, теперь содержат ссылку на руководство по устранению неполадок. Сообщения об ошибках, связанные со сбоями проверки подлинности Active Directory, теперь включают строку ошибки из базовой библиотеки.
Версия драйвера отправляется на сервер	Теперь версия драйвера корректно отправляется в базу данных во время `PRELOGIN`.
Идентификатор клиентского процесса	Идентификатор клиентского процесса теперь отправляется на сервер при запуске в Java версии 9 и более поздней версии. В Java 8 сохранена предыдущая функциональность с отправкой `0` в качестве идентификатора клиентского процесса.
Обновлены зависимости	Обновлены версии зависимостей для `azure-identity`, `azure-security-keyvault-keys`, `gson`, `antlr` и `bouncycastle`.
Удалены ненужные ссылки	Удалены неиспользуемые ссылки на класс Java 9 из jar-файла Java 8

Исправления в версии 9.4

Fix	Сведения
Проблема GitHub 1499	Исправлена ошибка: пакетная обработка завершается сбоем, если в строке подключения включено постоянное шифрование и вызывается метод clearParameters.
Проблема GitHub 1632	Исправлено: небольшая утечка памяти при создании подключения.
Проблема GitHub 1565	Исправлена проблема, из-за которой trustStorePassword имеет значение NULL при использовании applicationIntent=ReadOnly
Проблема GitHub 1568	Исправлена проблема, из-за которой перенаправленный маркер содержит именованный экземпляр в имени сервера
Проблема GitHub 1531	Исправлено возможное переполнение целочисленных значений при вызове TDSWriter.writeString()

9,2

Скачать Microsoft JDBC Driver 9.2.1 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 9.2.1 для SQL Server (TAR.GZ)

Номер версии: 9.2.1
Дата выпуска: 02 марта 2021 г.

Соответствие требованиям в версии 9.2

Изменение соответствий	Сведения
Скачайте последние обновления для драйвера JDBC версии 9.2.	• GitHub, 9.2.1. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	JAR-файлам в пакете 9.2 имена присваиваются с учетом совместимости версий Java. Например, файл mssql-jdbc-9.2.1.jre15.jar из пакета 9.2 должен использоваться с Java 15.
Совместимость с пакетом Java Development Kit (JDK) версий 15.0, 11.0 и 1.8.	Microsoft JDBC Driver for SQL Server версии 9.2 теперь совместим с пакетом Java Development Kit (JDK) версии 15.0 наряду с JDK версий 11.0 и 1.8.

Выпуски версии 9.2

Номер версии: 9.2.1
Дата выпуска: 02 марта 2021 г.

Устраненные проблемы в версии 9.2.1:

Исправлена проблема с пустым секретом клиента во время проверки подлинности ActiveDirectoryServicePrincipal в среде Azure.

Номер версии: 9.2.0
Выпущено: 29 января 2021 г.

Скачать Microsoft JDBC Driver 9.2.0 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 9.2.0 для SQL Server (TAR.GZ)

Поддержка JDK 15

Microsoft JDBC Driver for SQL Server версии 9.2 теперь совместим с пакетом Java Development Kit (JDK) версии 15.0 наряду с JDK версий 11.0 и 1.8.

Добавлена поддержка интерактивной проверки подлинности Azure Active Directory

Добавлен тип проверки подлинности	Сведения
Microsoft JDBC Driver for SQL Server версии 9.2 теперь поддерживает интерактивную проверку подлинности в Azure Key Vault.	См. дополнительные сведения об установке подключения с использованием проверки подлинности Azure Active Directory.

Добавлена поддержка проверки подлинности субъекта-службы Azure Active Directory

Добавлен тип проверки подлинности	Сведения
Microsoft JDBC Driver for SQL Server версии 9.2 теперь поддерживает проверку подлинности в Azure Key Vault с помощью идентификатора клиента и секрета удостоверения субъекта-службы.	См. дополнительные сведения об установке подключения с использованием проверки подлинности Azure Active Directory.

Библиотека Azure Key Vault обновлена до современной версии

Изменения библиотеки для Azure Key Vault Сведения

Microsoft JDBC Driver 9.2 перенесен из библиотеки и ADAL библиотек Azure Key Vault предыдущего поколения в более современные эквиваленты Azure Key Vault и удостоверений Azure. ИЗМЕНЕНИЕ ЗАВИСИМОСТЕЙ. Если вы используете проверку подлинности Azure Active Directory или Azure Key Vault, обновите зависимости приложения. Ознакомьтесь с требованиями к зависимостям при работе с поставщиком Azure Key Vault или проверке подлинности Azure Active Directory.

Изменения библиотеки для Azure Key Vault	Сведения
Microsoft JDBC Driver 9.2 перенесен из библиотеки и `ADAL` библиотек Azure Key Vault предыдущего поколения в более современные эквиваленты Azure Key Vault и удостоверений Azure.	ИЗМЕНЕНИЕ ЗАВИСИМОСТЕЙ. Если вы используете проверку подлинности Azure Active Directory или Azure Key Vault, обновите зависимости приложения. Ознакомьтесь с требованиями к зависимостям при работе с поставщиком Azure Key Vault или проверке подлинности Azure Active Directory.

Параметр useBulkCopyForBatchInsert включен для серверов, отличных от Azure Synapse Analytics

Изменения в использовании useBulkCopyForBatchInsert для серверов, отличных от Azure Synapse Analytics	Сведения
Microsoft JDBC Driver версии 9.2 теперь поддерживает интерфейс API массового копирования для выполнения операций пакетной вставки на серверах, отличных от Azure Synapse Analytics.	См. статью Использование API массового копирования для операции пакетной вставки.

8.4

Скачать Microsoft JDBC Driver 8.4 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 8.4 для SQL Server (TAR.GZ)

Номер версии: 8.4.1
Выпущено: 27 августа 2020 г.

Соответствие требованиям в версии 8.4

Изменение соответствий	Сведения
Загрузите последние обновления для драйвера JDBC версии 8.4.	• GitHub, 8.4.1. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	JAR-файлам в пакете 8.4 имена присваиваются с учетом совместимости версий Java. Например, файл mssql-jdbc-8.4.1.jre14.jar из пакета 8.4 должен использоваться с Java 14.
Совместимость с пакетом Java Development Kit (JDK) версий 14.0, 11.0 и 1.8.	Microsoft JDBC Driver версии 8.4 для SQL Server теперь совместим с пакетом Java Development Kit (JDK) версии 14.0 наряду с JDK версий 11.0 и 1.8.

Выпуски версии 8.4

Номер версии: 8.4.1
Выпущено: 27 августа 2020 г.
Исправленные проблемы:

Исправление проблемы с SQLServerConnectionPoolProxy несовместимым с delayLoadingLobs
Исправлена потенциальная проблема NullPointerException с delayLoadingLobs
Исправлена проблема с расшифровкой ключей шифрования столбцов при использовании хранилища сертификатов Windows

Номер версии: 8.4.0
Выпущено: 31 июля 2020 г.

Поддержка JDK 14

Microsoft JDBC Driver версии 8.4 для SQL Server теперь совместим с пакетом Java Development Kit (JDK) версии 14.0 наряду с JDK версий 11.0 и 1.8.

Добавлена поддержка проверки подлинности для Azure Key Vault с помощью управляемого удостоверения.

Добавлен тип проверки подлинности	Сведения
Microsoft JDBC Driver 8.4 для SQL Server теперь поддерживает проверку подлинности для Azure Key Vault с помощью управляемого удостоверения.	См. Использование функции Always Encrypted с драйвером JDBC

Расширенная поддержка массового копирования для хранилища данных Azure

Изменения в массовом копировании для хранилища данных Azure	Сведения
В Microsoft JDBC 8.4 добавлено новое свойство соединения `sendTemporalDataTypesAsStringForBulkCopy`. Это логическое свойство равно TRUE по умолчанию.	См. Использование массового копирования с драйвером JDBC.

Добавлена поддержка кэширования DNS в Azure SQL.

Кэширование DNS	Сведения
Microsoft JDBC Driver 8.4 для SQL Server теперь поддерживает кэширование DNS для SQL Server на виртуальных машинах Azure.

Добавлена обратная совместимость для потоковой передачи объектов LOB

Потоковая передача LOB Сведения

В Microsoft JDBC Driver версии 8.4 для SQL Server добавлено новое свойство соединения delayLoadingLobs. Значение delayLoadingLobs FALSE приводит к тому, что все бизнес-объекты, полученные из ResultSet, не передаются в поток. Этот параметр означает, что драйвер загружает весь бизнес-объект в память одновременно, аналогично тому, как драйвер работал до выпуска версии 6.4.

Потоковая передача LOB	Сведения
В Microsoft JDBC Driver версии 8.4 для SQL Server добавлено новое свойство соединения `delayLoadingLobs`.	Значение `delayLoadingLobs` FALSE приводит к тому, что все бизнес-объекты, полученные из ResultSet, не передаются в поток. Этот параметр означает, что драйвер загружает весь бизнес-объект в память одновременно, аналогично тому, как драйвер работал до выпуска версии 6.4.

Добавлена поддержка проверки подлинности сертификата клиента для сценариев замыкания на себя.

Проверка подлинности сертификатов клиента	Сведения
В Microsoft JDBC Driver 8.4 для SQL Server добавлен новый метод проверки подлинности, который называется "проверка подлинности с помощью сертификата клиента", для сценариев замыкания на себя.	См. Проверка подлинности сертификата клиента для сценариев замыкания на себя.

8.2

Скачать Microsoft JDBC Driver 8.2 для SQL Server (ZIP)
Скачать Microsoft JDBC Driver 8.2 для SQL Server (TAR.GZ)

Номер версии: 8.2.2 выпущено: 24 марта 2020 г.

Соответствие требованиям в версии 8.2

Изменение соответствий	Сведения
Скачайте последние обновления для драйвера JDBC версии 8.2.	• GitHub, 8.2.2. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	JAR-файлам в пакете 8.2 имена присваиваются с учетом совместимости версий Java. Например, файл mssql-jdbc-8.2.2.jre11.jar из пакета 8.2 должен использоваться с Java 11.
Совместимость с пакетом Java Development Kit (JDK) версий 13.0, 11.0 и 1.8.	Microsoft JDBC Driver версии 8.2 для SQL Server теперь совместим с пакетом Java Development Kit (JDK) версии 13.0 наряду с JDK версий 11.0 и 1.8.

Выпуски версии 8.2

Номер версии: 8.2.2
Выпущено: 24 марта 2020 г.
Исправленные проблемы:

Добавлен параметр для настройки списка доверенных конечных точек Azure Key Vault

Номер версии: 8.2.1
Выпущено: 26 февраля 2020 г.
Исправленные проблемы:

Исправлена потенциальная проблема NullPointerException при получении данных в качестве типа java.time.LocalTime или java.time.LocalDate с помощью SQLServerResultSet.getObject()

Номер версии: 8.2.0
Выпущено: 31 января 2020 г.

Поддержка JDK 13

Microsoft JDBC Driver версии 8.2 для SQL Server теперь совместим с пакетом Java Development Kit (JDK) версии 13.0 наряду с JDK версий 11.0 и 1.8.

Always Encrypted с безопасными анклавами.

Изменение функции Always Encrypted	Сведения
Microsoft JDBC Driver версии 8.2 для SQL Server теперь поддерживает Always Encrypted с безопасными анклавами. Сведения см. здесь: Always Encrypted с безопасными анклавами.
Дополнительные сведения и пример кода.	См. раздел Always Encrypted с безопасными анклавами.

Повышение производительности при извлечении темпоральных типов данных из SQL Server ¹

Изменение, касающееся темпоральных типов данных	Сведения
Повышена производительность Microsoft JDBC Driver версии 8.2 для SQL Server при извлечении темпоральных типов данных из SQL Server.	Это изменение устраняет ненужные преобразования темпоральных типов данных, исключая использование java.util.Calendar, где это возможно.
Это улучшение производительности влияет на следующий список временных типов данных; в формате "Тип данных SQL Server" (сопоставление Java).	date (java.sql.Date), datetime (java.sql.Timestamp), datetime2 (java.sql.Timestamp), smalldatetime (java.sql.Timestamp) и time (java.sql.Time).

¹ Из-за различий в том, как часовые пояса обрабатываются между java.util.Calendar и JAVA.time.LocalDateTime API, темпоральными типами данных с пользователем, предоставленными пользователем объектом java.util.Calendar, связанным с ним или microsoft.sql.DateTimeOffset, не пользуются этим улучшением.

Развертывание mssql-jdbc_auth-<версия>-<архитектура>.dll (ранее sqljdbc_auth.dll) в репозитории Maven

Изменение, касающееся sqljdbc_auth.dll	Сведения
Начиная с Microsoft JDBC Driver 8.2 для SQL Server драйвер использует mssql-jdbc_auth-version-arch<><>.dll вместо sqljdbc_auth.dll использовать функцию проверки подлинности Azure Active Directory.
Библиотека DLL передается в репозиторий Maven для упрощения доступа.	См. эту страницу.

Известные проблемы в версии 8.2

Известные проблемы	Сведения
При использовании Always Encrypted с безопасными анклавами с Java 8.	Пользователи должны включать поставщик BouncyCastle в качестве зависимостей ИЛИ карты или загрузки поставщика безопасности, который поддерживает алгоритм подписи RSASSA-PSS.

7.4.1

Скачать Microsoft JDBC Driver 7.4.1 для SQL Server (самораспаковывающийся архив)
Скачать Microsoft JDBC Driver 7.4.1 для SQL Server (TAR.GZ)

Номер версии: 7.4.1
Выпущено: 2 августа 2019 г.

Соответствие требованиям в версии 7.4

Изменение соответствий	Сведения
Скачайте последние обновления для драйвера JDBC версии 7.4.	• GitHub, 7.4.1. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	JAR-файлам в пакете 7.4 имена присваиваются с учетом совместимости версий Java. Например, файл mssql-jdbc-7.4.1.jre11.jar из пакета 7.4 должен использоваться с Java 11.
Совместимость с пакетом Java Development Kit (JDK) версий 12.0, 11 и 1.8.	Microsoft JDBC Driver версии 7.4 для SQL Server совместим с пакетом Java Development Kit (JDK) версии 12.0 наряду с JDK версии 11.0 и 1.8.

Выпуски версии 7.4

Номер версии: 7.4.1
Выпущено: 2 августа 2019 г.
Исправленные проблемы:

Отменены новые реализации API hashCode() и equals() из SQLServerDataTable и SQLServerDataColumn, так как изменение API нарушило обратную совместимость

Номер версии: 7.4.0
Выпущено: 31 июля 2019 г.

Поддержка JDK 12

Microsoft JDBC Driver версии 7.4 для SQL Server совместим с пакетом Java Development Kit (JDK) версии 12.0 наряду с JDK версии 11.0 и 1.8.

Добавлена проверка подлинности NTLM

Изменение NTLM	Сведения
Поддержка режима проверки подлинности NTLM.	Этот режим проверки подлинности позволяет клиентам под управлением Windows и других ОС проходить проверку подлинности в SQL Server с учетными данными пользователей домена Windows.
Дополнительные сведения и пример приложения для использования этого режима проверки подлинности.	См. статью о подключении с использованием проверки подлинности NTLM.

Добавлена возможность запросов ParameterMetaData через useFmtOnly

Изменение useFmtOnly	Сведения
Добавлено свойство подключения useFmtOnly.	Эта функция позволяет пользователям при необходимости запрашивать ParameterMetaData через устаревший API `SET FMTONLY ON`. Этот параметр полезен для сценариев, где `sp_describe_undeclared_parameters` не выполняется должным образом.
Подробные сведения и ограничения.	См. об использовании useFmtOnly.

Пакет SDK для Microsoft Azure Key Vault для Java обновлен до версии 1.2.1.

Изменение пакета SDK для Key Vault	Сведения
Зависимость Maven для пакета SDK Microsoft Azure Key Vault для Java обновлена до версии 1.2.1.
Пакет SDK для Microsoft Azure Key Vault WebKey удален как зависимость Maven.
Дополнительные сведения.	См. дополнительные сведения о зависимостях компонентов Microsoft JDBC Driver для SQL Server.

Известные проблемы в версии 7.4

Известные проблемы	Сведения
При использовании проверки подлинности NTLM.	Одновременное включение расширенной защиты и шифрования соединений в настоящий момент не поддерживается.
При использовании useFmtOnly.	Недостатки логики синтаксического анализа SQL могут вызвать некоторые проблемы с функцией. Дополнительные сведения и варианты обходного решения см. в разделе UsingFmtOnly.

7.2.2

Скачать Microsoft JDBC Driver 7.2.2 для SQL Server (самораспаковывающийся архив)
Скачать Microsoft JDBC Driver 7.2.2 для SQL Server (TAR.GZ)

Номер версии: 7.2.2
Выпущено: 16 апреля 2019 г.

Соответствие требованиям в версии 7.2

Изменение соответствий	Сведения
Скачайте последние обновления для драйвера JDBC версии 7.2.	• GitHub, 7.2.2. • Maven Central.
Полностью соответствует спецификации API JDBC версии 4.2.	JAR-файлам в пакете 7.2 имена присваиваются в соответствии с совместимостью версий Java. Например, файл mssql-jdbc-7.2.2.jre11.jar из пакета 7.2 должен использоваться с Java 11.
Совместимость с пакетом Java Development Kit (JDK) версии 11.0 в дополнение к JDK версии 1.8.	Microsoft JDBC Driver версии 7.2 для SQL Server совместим с пакетом Java Development Kit (JDK) версии 11.0 в дополнение к JDK версии 1.8.

Выпуски версии 7.2

Номер версии: 7.2.2
Выпущено: 16 апреля 2019 г.
Исправленные проблемы:

Исправлены проблемы, при которых идентификаторы действий (ActivityID) не очищались должным образом.

Номер версии: 7.2.1
Выпущено: 11 февраля 2019 г.
Исправленные проблемы:

Исправлены проблемы синтаксического анализа с определенными параметризованными запросами.

Номер версии: 7.2.0
Выпущено: 31 января 2019 г.

Проверка подлинности Azure Active Directory с использованием управляемого удостоверения.

Изменение MSI

Сведения

Поддерживается режим проверки подлинности с помощью Управляемого удостоверения (MSI) Active Directory.

Этот режим проверки подлинности применяется в ресурсах Azure с поддержкой активной функции Identity.

Оба типа Управляемых удостоверений (MSI) поддерживаются драйвером для получения accessToken для установления безопасного соединения.

Дополнительные сведения и пример приложения для использования этого режима проверки подлинности.

См. дополнительные сведения об установке подключения с использованием аутентификации Azure Active Directory.

Представление поддержки Open Service Gateway Initiative (OSGi)

Изменение OSGi	Сведения
Добавлена реализация DataSourceFactory.	• `org.osgi.service.jdbc.DataSourceFactory` • `com.microsoft.sqlserver.jdbc.osgi.SQLServerDataSourceFactory`
Добавлена реализация Activator.	• `org.osgi.framework.BundleActivator` • `com.microsoft.sqlserver.jdbc.osgi.Activator`

Представление API-интерфейсов SQLServerError

Изменение API ошибок	Сведения
Представлен API SQLServerError.	Api Getter для получения дополнительных сведений об ошибке, созданной на сервере. • `SQLServerException.getSQLServerError()` • `SQLServerError`
Дополнительные сведения.	См. дополнительные сведения об обработке ошибок.

Обновлена Библиотека проверки подлинности Microsoft Azure Active Directory (ADAL4J) для Java версии 1.6.3.

Изменение ADAL4J	Сведения
Зависимость Maven в ADAL4J обновлена до версии 1.6.3.
Клиентская среда выполнения Java для AutoRest представлена в качестве зависимости Maven версии 1.6.5.
Дополнительные сведения.	См. дополнительные сведения о зависимостях компонентов Microsoft JDBC Driver для SQL Server.

Пакет SDK для Microsoft Azure Key Vault для Java обновлен до версии 1.2.0

Изменение пакета SDK для Key Vault	Сведения
Зависимость Maven для пакета SDK для Microsoft Azure Key Vault для Java обновлена до версии 1.2.0.
Общие сведения о зависимости Maven версии 1.2.0 для пакета Microsoft Azure SDK для Key Vault WebKey.
Дополнительные сведения.	См. дополнительные сведения о зависимостях компонентов Microsoft JDBC Driver для SQL Server.

Известные проблемы в версии 7.2

Известные проблемы	Сведения
Параметризованные запросы в некоторых случаях.	Чтобы устранить эту проблему, в феврале 2019 года было выпущено обновление версии 7.2.0 (7.2.1).
Удаление из ActivityIds.	Чтобы устранить эту проблему, в апреле 2019 года было выпущено обновление версии 7.2.1 (7.2.2).

7.0

Скачать Microsoft JDBC Driver 7.0 для SQL Server (самораспаковывающийся архив)
Скачать Microsoft JDBC Driver 7.0 для SQL Server (TAR.GZ)

Номер версии: 7.0.0
Выпущено: 31 июля 2018 г.

Microsoft JDBC Driver версии 7.0 для SQL Server полностью соответствует спецификации API JDBC версии 4.2. JAR-файлам в пакете 7.0 имена присваиваются в соответствии с совместимостью версий Java. Например, файл mssql-jdbc-7.0.0.jre10.jar из пакета 7.0 должен использоваться с Java 10.

Поддержка JDK 10

Microsoft JDBC Driver версии 7.0 для SQL Server совместим с пакетом Java Development Kit (JDK) версии 10.0 в дополнение к JDK версии 1.8. Это обновление также предоставляет Automatic-Module-Name драйвера в качестве com.microsoft.sqlserver.jdbc с помощью файла манифеста.

Поддержка пространственных типов данных

Microsoft JDBC Driver версии 7.0 для SQL Server теперь поддерживает пространственные типы данных, такие как география и геометрия. Дополнительные сведения о пространственных типах данных API-интерфейсов и их использовании см. здесь.

Реализация для JDBC 4.3, в которой представлены API java.sql.Connection beginRequest() и endRequest()

Microsoft JDBC Driver версии 7.0 для SQL Server теперь реализует API beginRequest() и endRequest() из класса java.sql.Connection. Эти API-интерфейсы были представлены в спецификации JDBC 4.3 и JDK 9. Дополнительные сведения о возможности драйвера реализовать эти API-интерфейсы см. в статьеСоответствие требованиям JDBC 4.3 для JDBC Driver.

Включено обнаружение и классификация данных SQL

Microsoft JDBC Driver версии 7.0 для SQL Server позволяет включить обнаружение и классификацию данных SQL в любой целевой базе данных, поддерживающей эту функцию. Драйвер теперь предоставляет API-интерфейсы SQLServerResultSet.getSensitivityClassification() для извлечения этой информации из полученного ResultSet.

Дополнительные сведения см. в статье об обнаружении и классификации данных SQL с помощью JDBC Driver.

Добавлено свойство подключения: useBulkCopyForBatchInsert

Microsoft JDBC Driver версии 7.0 для SQL Server предоставляет новое свойство соединения — useBulkCopyForBatchInsert. Это свойство поддерживается только Azure Synapse Analytics.

По умолчанию это свойство отключено. Вы можете включить его, чтобы повысить производительность пользовательских приложений при отправке больших объемов данных в Azure Synapse Analytics. Включение этого свойства изменяет поведение операций пакетной вставки на переход на операции массового копирования с предоставленными пользователем данными. Дополнительные сведения об этом свойстве и его ограничениях см. в статье Использование API массового копирования для операции пакетной вставки.

Добавлено свойство подключения: cancelQueryTimeout

Microsoft JDBC Driver версии 7.0 для SQL Server предоставляет новое свойство подключения, cancelQueryTimeout, для отключения queryTimeout на объектах java.sql.Connection и java.sql.Statement.

Добавлены конструкторы поставщика Azure Key Vault

Microsoft JDBC Driver версии 7.0 для SQL Server возвращает ранее удаленный конструктор для SQLServerColumnEncryptionAzureKeyVaultProvider. Это дало возможность при выполнении проверки подлинности с помощью пользовательского метода, реализованного через SQLServerKeyVaultAuthenticationCallback, получить токен доступа.

Новые конструкторы имеют следующее определение.

/* This constructor is added to provide backward compatibility with 6.0
* version of the driver. It is marked deprecated for removal in the next
* stable release.
*/
@Deprecated
public SQLServerColumnEncryptionAzureKeyVaultProvider(
        SQLServerKeyVaultAuthenticationCallback authenticationCallback,
        ExecutorService executorService) throws SQLServerException;

/*New constructor to replace the above constructor*/
public SQLServerColumnEncryptionAzureKeyVaultProvider(
            SQLServerKeyVaultAuthenticationCallback authenticationCallback) throws SQLServerException;

Обновлена версия библиотеки проверки подлинности Microsoft Azure Active Directory (ADAL4J) для Java: 1.6.0.

Microsoft JDBC Driver версии 7.0 для SQL Server обновил зависимость Maven "Библиотека проверки подлинности Microsoft Azure Active Directory (ADAL4J) для Java" до версии 1.6.0. Дополнительные сведения см. в статье Зависимости компонентов Microsoft JDBC Driver для SQL Server.

6,4

Скачать Microsoft JDBC Driver 6.4 для SQL Server (самораспаковывающийся архив)
Скачать Microsoft JDBC Driver 6.4 для SQL Server (TAR.GZ)

Номер версии: 6.4.0
Выпущено: 27 февраля 2018 г.

Microsoft JDBC Driver версии 6.4 для SQL Server полностью соответствует спецификации JDBC версий 4.1 и 4.2. JAR-файлам в пакете 6.4 имена присваиваются в соответствии с совместимостью версий Java. Например, файл mssql-jdbc-6.4.0.jre8.jar из пакета 6.4 должен использоваться с Java 8.

Поддержка JDK 9

Драйвер поддерживает JDK версии 9.0 в дополнение к версиям 8.0 и 7.0.

Соответствие требованиям JDBC 4.3

Драйвер поддерживает спецификацию Java Database Connectivity API 4.3 в дополнение к версиям 4.1 и 4.2. Методы API JDBC 4.3 добавлены, но еще не реализованы. Дополнительные сведения см. в статье Соответствие требованиям JDBC 4.3 для JDBC Driver.

Добавлено свойство подключения: sslProtocol

Новое свойство подключения дает пользователям возможность указывать ключевое слово протокола TLS. Возможные значения: TLS, TLSv1, TLSv1.1 и TLSv1.2. Дополнительные сведения см. в разделе SSLProtocol.

Устаревшее свойство подключения: fipsProvider

Свойство подключения fipsProvider удалено из списка принятых свойств подключения. Дополнительные сведения см. на странице Запрос на вытягивание GitHub.

Добавлены свойства подключения для указания пользовательского TrustManager

Теперь драйвер поддерживает указание пользовательского TrustManager с добавленными свойствами подключения trustManagerClass и trustManagerConstructorArg. Вы можете динамически указывать набор сертификатов, которые проверяются при каждом подключении, без изменения глобальных параметров среды виртуальной машины Java (JVM).

В параметры, возвращающие табличные значения, добавлена поддержка datetime или smallDatetime

Теперь при использовании параметров, возвращающих табличные значения, драйвер поддерживает типы данных datetime и smallDatetime.

Добавлена поддержка типа данных sql_variant

Теперь для использования с SQL Server драйвер JDBC поддерживает типы данных sql_variant. Тип данных sql_variant также поддерживается такими функциями, как параметры табличных значений и массовое копирование, со следующими ограничениями.

Для значений даты:

Когда вы используете параметр табличного значения для заполнения таблицы, которая содержит значения datetime, smalldatetime или date, хранящиеся в столбце sql_variant, вызывается метод getDateTime(), getSmallDateTime() или getDate(), когда результирующий набор не работает и выдает следующее исключение.

java java.lang.String cannot be cast to java.sql.Timestamp

Чтобы этого избежать, используйте метод getString() или getObject().
Использование возвращающего табличное значение параметра с sql_variant для значений null.

Если вы используете TVP для заполнения таблицы и отправки значения sql_variant NULL в тип столбца, возникает исключение. Вставка значения NULL в столбец типа sql_variant в параметре табличного значения в настоящее время не поддерживается.

Реализовано кэширование метаданных подготовленной инструкции

В драйвере JDBC реализовано кэширование метаданных подготовленной инструкции для повышения производительности. Теперь драйвер поддерживает кэширование метаданных подготовленной инструкции в драйвере с использованием свойств подключения disableStatementPooling и statementPoolingCacheSize. По умолчанию эта функция выключена. Дополнительные сведения см. в разделе Кэширование метаданных подготовленной инструкции для JDBC Driver.

Добавлена поддержка интегрированной проверки подлинности Azure AD в Linux и macOS

Драйвер JDBC поддерживает встроенную проверку подлинности Azure Active Directory во всех поддерживаемых операционных системах (Windows, Linux, macOS) с Kerberos. Кроме того, в операционных системах Windows пользователи могут проходить проверку подлинности с помощью mssql-jdbc_auth-<версия>-<архитектура>.dll.

Обновлена версия библиотеки проверки подлинности Microsoft Azure Active Directory (ADAL4J) для Java: 1.4.0.

В драйвере JDBC зависимость Maven "Библиотека проверки подлинности Microsoft Azure Active Directory (ADAL4J) для Java" обновлена до версии 1.4.0. Дополнительные сведения см. в статье Зависимости компонентов Microsoft JDBC Driver для SQL Server.

6,2

Скачать Microsoft JDBC Driver 6.2 для SQL Server (самораспаковывающийся архив)
Скачать Microsoft JDBC Driver 6.2 для SQL Server (TAR.GZ)

Номер версии: 6.2.2
Выпущено: 29 сентября 2017 г.

Microsoft JDBC Driver версии 6.2 для SQL Server полностью соответствует спецификации JDBC версий 4.1 и 4.2. JAR-файлам в пакете 6.2 имена присваиваются в соответствии с совместимостью версий Java. Например, файл mssql-jdbc-6.2.2.jre8.jar из пакета 6.2 должен использоваться с Java 8.

Выпуски версии 6.2

Номер версии: 6.2.2
Выпущено: 3 октября 2017 г.
Исправленные проблемы:

Изменена зависимость ADAL4J до версии 1.2.0 и зависимости Azure Key Vault до версии 1.0.0

Номер версии: 6.2.1
Выпущено: 14 июля 2017 г.
Исправленные проблемы:

Исправлена проблема при выполнении запросов без параметров preparedStatement

Номер версии: 6.2.0
Выпущено: 30 июня 2017 г.

Примечание.

Проблема с улучшением кэширования метаданных была обнаружена в RTW JDBC 6.2, выпущенном 29 июня 2017 года. Выполнен откат улучшений, а новые JAR-файлы (версии 6.2.1) выпущены 17 июля 2017 года.

С помощью еще одного улучшения версия зависимой библиотеки Azure Key Vault обновлена до версии 1.0.0, а новые файлы JAR-файлы (версии 6.2.2) были выпущены 19 октября 2017 года.

Скачайте последние обновления для JDBC Driver 6.2 с помощью приведенных выше ссылок, GitHub или Maven Central. Для использования JAR-файлов выпуска 6.2.2 обновите проекты. Дополнительные сведения см. в заметках о выпуске 6.2.1 и 6.2.2.

Поддержка Azure AD для Linux

Подключите свои приложения Linux к базе данных SQL Azure, используя проверку подлинности Azure AD через имя пользователя и пароль, а также методы доступа к токену.

Виртуальные машины Java с поддержкой стандарта FIPS

Теперь драйвер JDBC можно использовать на виртуальных машинах Java, работающих в режиме использования федерального стандарта обработки информации (FIPS) 140 в соответствии с федеральными стандартами.

Улучшения проверки подлинности Kerberos

Теперь драйвер JDBC поддерживает следующее.

Метод субъект/пароль для приложений, в которых конфигурация Kerberos не может быть изменена или не может получить новый токен или таблицу ключей. Этот метод можно использовать для проверки подлинности на экземпляре SQL Server, который разрешает только проверку подлинности Kerberos.
Проверка подлинности между областями с использованием встроенной проверки подлинности Kerberos без явного указания имени участника-службы сервера. Теперь драйвер автоматически вычисляет области, даже если они не указаны.
Ограниченное делегирование Kerberos путем принятия учетных данных олицетворенного пользователя в качестве объекта учетных данных GSS через источник данных. Эти олицетворенные учетные данные затем используются для установления подключения Kerberos.

Добавлено время ожидания

Теперь драйвер JDBC поддерживает следующие настраиваемые значения времени ожидания. Вы можете изменить их в зависимости от потребностей своего приложения.

Query timeout Для управления числом секунд, которые нужно ожидать до истечения времени ожидания при выполнении запроса.
Socket timeout Чтобы указать количество миллисекундах, которые следует ожидать до истечения времени ожидания в сокете, считывается или принимается.

6.1

Версия 6.1.0:
Выпущено: 17 ноября 2016 г.

Microsoft JDBC Driver версии 6.1 для SQL Server полностью соответствует спецификации JDBC версий 4.1 и 4.2. Этот выпуск является первоначальным выпуском JDBC Driver с открытым исходным кодом. Исходный код можно найти по тегу GitHub v6.1.0. Он компилирует файлы mssql-jdbc-6.1.0.jre8.jar и mssql-jdbc-6.1.0.jre7.jar, которые соответствуют совместимости версий Java.

6,0

Скачать Microsoft JDBC Driver 6.0 для SQL Server (самораспаковывающийся архив)
Скачать Microsoft JDBC Driver 6.0 для SQL Server (TAR.GZ)

Номер версии: 6.0.8112
Выпущено: 17 января 2017 г.

Microsoft JDBC Driver версии 6.0 для SQL Server полностью соответствует спецификации JDBC версий 4.1 и 4.2. JAR-файлам в пакете 6.0 имена присваиваются в соответствии с их совместимостью с версией API JDBC. Например, файл sqljdbc42.jar из пакета 6.0 совместим с API JDBC 4.2. Аналогичным образом файл sqljdbc41.jar совместим с API JDBC 4.1.

Чтобы убедиться, что у вас есть правильный файл sqljdbc42.jar или sqljdbc41.jar, запустите следующие строки кода. Если выходные данные — "Driver version: 6.0.7507.100", у вас есть пакет JDBC Driver 6.0.

Connection conn = DriverManager.getConnection("jdbc:sqlserver://<server>;encrypt=true;user=<user>;password=<password>;");
System.out.println("Driver version: " + conn.getMetaData().getDriverVersion());

Always Encrypted

Драйвер поддерживает функцию постоянного шифрования в SQL Server 2016. Эта функция гарантирует, что конфиденциальные данные никогда не будут отображаться в виде открытого текста в экземпляре SQL Server. Always Encrypted работает путем прозрачного шифрования данных в приложении, чтобы SQL Server обрабатывал только зашифрованные данные, а не значения обычного текста. Даже в случае компрометации экземпляра SQL или хост-компьютера злоумышленник получит только зашифрованный текст конфиденциальных данных. Дополнительные сведения см. в статье Использование функции Always Encrypted с драйвером JDBC.

Международное доменное имя (IDN)

Драйвер поддерживает международные доменные имена (IDN) в качестве имен серверов. Дополнительные сведения см. в разделе "Использование международных доменных имен" в статье Функции поддержки различных языков драйвера JDBC.

Параметризованные запросы

Драйвер теперь поддерживает получение метаданных параметра с подготовленными инструкциями для сложных запросов, например подзапросов или соединений. Это улучшение доступно только при использовании SQL Server 2012 и более новых версий.

Azure Active Directory

Проверка подлинности Azure AD — это механизм подключения к Базе данных SQL Azure с помощью удостоверений в Azure AD. Проверка подлинности AAD используется для централизованного управления удостоверениями пользователей базы данных и в качестве альтернативы проверке подлинности SQL Server.

Вы можете использовать драйвер JDBC 6.0, чтобы указать учетные данные AAD в строке подключения JDBC для подключения к базе данных SQL Azure. Дополнительные сведения см. в разделе о свойстве проверки подлинности в статье Задание свойств соединения.

Возвращающие табличные значения параметры

Параметры, возвращающие табличное значение, упрощают маршалинг нескольких строк данных из клиентского приложения в SQL Server, устраняя потребность в нескольких круговых путях или специальной серверной логике для обработки данных. Параметры, возвращающие табличное значение, можно использовать для инкапсуляции строк данных в клиентском приложении и их отправки на сервер единой параметризованной командой. Входящие строки данных хранятся в переменной таблицы, которой затем можно управлять с помощью Transact-SQL. Дополнительные сведения см. в разделе Использование параметров, возвращающих табличные значения.

Группы доступности Always On

Теперь драйвер поддерживает прозрачное подключение к группам доступности Always On. Драйвер быстро обнаруживает текущую топологию групп доступности AlwaysOn серверной инфраструктуры и прозрачно подключается к текущему активному серверу.

4.2

Скачать Microsoft JDBC Driver 4.2 для SQL Server (самораспаковывающийся архив)
Скачать Microsoft JDBC Driver 4.2 для SQL Server (TAR.GZ)

Номер версии: 4.2.8112
Выпущено: 24 августа 2015 г.

Microsoft JDBC Driver версии 4.2 для SQL Server полностью соответствует спецификации JDBC версий 4.1 и 4.2. JAR-файлам в пакете 4.2 имена присваиваются в соответствии с их совместимостью с версией API JDBC. Например, файл sqljdbc42.jar из пакета 4.2 совместим с API JDBC 4.2. Аналогичным образом файл sqljdbc41.jar совместим с API JDBC 4.1.

Чтобы убедиться, что у вас есть правильный файл sqljdbc42.jar или sqljdbc41.jar, запустите следующие строки кода. Если выходные данные — "Driver version: 4.2.6420.100", у вас есть пакет JDBC Driver 4.2.

Connection conn = DriverManager.getConnection("jdbc:sqlserver://<server>;encrypt=true;user=<user>;password=<password>;");
System.out.println("Driver version: " + conn.getMetaData().getDriverVersion());

Поддержка JDK 8

Драйвер поддерживает JDK версии 8.0 в дополнение к версиям 7.0, 6.0 и 5.0.

Соответствие JDBC 4.1 и 4.2

Драйвер поддерживает спецификации Java Database Connectivity API 4.1 и 4.2 в дополнение к версии 4.0. Дополнительные сведения см. в статьях Соответствие JDBC 4.1 для JDBC Driver и Соответствие JDBC 4.2 для JDBC Driver.

Массовое копирование

Функция массового копирования используется для быстрого копирования больших объемов данных в таблицы или представления в базах данных SQL Server. Дополнительные сведения см. в статье Использование массового копирования с драйвером JDBC.

Возможность отката транзакций XA

Добавлены новые параметры времени ожидания для существующего автоматического отката неподготовленных транзакций. Дополнительные сведения см. в статье Основные сведения о транзакциях XA.

Новое свойство соединения участника Kerberos

Драйвер использует новое свойство соединения для улучшения гибкости подключений Kerberos. Дополнительные сведения см. в статье Использование встроенной проверки подлинности Kerberos для соединения с SQL Server.

4,1

Номер версии: 4.1.8112
Выпущено: 12 декабря 2014 г.

Поддержка JDK 7

Драйвер поддерживает JDK версии 7.0 в дополнение к версиям 6.0 и 5.0.

Процессор Itanium не поддерживается для приложений JDBC Driver

Microsoft JDBC Driver для SQL Server не поддерживается на компьютерах с Itanium.

См. также

Общие сведения о драйвере JDBC

Поделиться через