Соответствие JDBC 4.2 для JDBC Driver

Статья
06/02/2023

Примечание

Версии Microsoft JDBC Driver для SQL Server до 4.2 соответствуют спецификациям Java Database Connectivity API 4.0. Этот раздел не применяется к версиям до 4.2.

Спецификация Java Database Connectivity API 4.2 поддерживается драйвером Microsoft JDBC Driver 4.2 для SQL Server со следующими методами API.

SQLServerStatement, класс

Новые методы	Описание	Значимые реализации
long[] executeLargeBatch()	Выполняет пакет, где количество возвращаемых обновлений может быть типа long.	Реализовано, как описано в интерфейсе java.sql.Statement. Дополнительные сведения см. на странице о java.sql.Statement.
long executeLargeUpdate(String sql) long executeLargeUpdate(String sql, int autoGeneratedKeys) long executeLargeUpdate(String sql, int[] columnIndexes) executeLargeUpdate(String sql, String[] columnNames)	Выполняет инструкцию DML/DDL, где количество возвращаемых обновлений может быть типа long. Существует четыре новых метода (перегруженных) для поддержки значения типа long.	Реализовано, как описано в интерфейсе java.sql.Statement. Дополнительные сведения см. на странице о java.sql.Statement.
long getLargeMaxRows()	Возвращает максимальное число строк как значение типа long, которое может содержать результирующий набор.	SQL Server поддерживает только целочисленные пределы для максимального числа строк. Дополнительные сведения см. на странице о java.sql.Statement.
long getLargeUpdateCount()	Возвращает текущий результат в виде счетчика обновлений типа long.	SQL Server поддерживает только целочисленные пределы для максимального числа строк. Дополнительные сведения см. на странице о java.sql.Statement.
void setLargeMaxRows(long max)	Задает максимальное число строк как значение типа long, которое может содержать результирующий набор.	SQL Server поддерживает только целочисленные пределы для максимального числа строк. Этот метод вызывает неподдерживаемое исключение, если в качестве параметра передается значение, большее максимального целого числа. Дополнительные сведения см. на странице о java.sql.Statement.

SQLServerCallableStatement, класс

Новые методы	Описание	Значимые реализации
void registerOutParameter(int parameterIndex, SQLType sqlType) void registerOutParameter(int parameterIndex, SQLType sqlType, int scale) void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) void registerOutParameter(String parameterName, SQLType sqlType) void registerOutParameter(String parameterName, SQLType sqlType, int scale) registerOutParameter(String parameterName, SQLType sqlType, String typeName)	Регистрирует параметр OUT. Существует шесть новых методов (перегруженных) для поддержки нового интерфейса SQLType.	Реализовано, как описано в интерфейсе java.sql.CallableStatement. Дополнительные сведения см. на странице о java.sql.CallableStatement.
void setObject(String parameterName, Object x, SQLType targetSqlType) void setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength)	Задает значение параметра указанного объекта. Существует два новых метода (перегруженных) для поддержки нового интерфейса SQLType.	Реализовано, как описано в интерфейсе java.sql.CallableStatement. Дополнительные сведения см. на странице о java.sql.CallableStatement.

SQLServerPreparedStatement, класс

Новые методы	Описание	Значимые реализации
long executeLargeUpdate()	Выполняет инструкции DML/DDL и возвращает счетчик обновлений типа long.	Реализовано, как описано в интерфейсе java.sql.PreparedStatement. Дополнительные сведения см. на странице о java.sql.PreparedStatement.
void setObject(int parameterIndex, Object x, SQLType targetSqlType) void setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength)	Задает значение параметра указанного объекта. Существует два новых метода (перегруженных) для поддержки нового интерфейса SQLType.	Реализовано, как описано в интерфейсе java.sql.PreparedStatement. Дополнительные сведения см. на странице о java.sql.PreparedStatement.

SQLServerDatabaseMetaData, класс

Новые методы	Описание	Значимые реализации
long getMaxLogicalLobSize()	Возвращает максимальное число байтов, допустимых для этой базы данных в качестве логического размера LOB.	Для SQL Server это значение равно 2^31-1. Дополнительные сведения см. на странице о java.sql.DatabaseMetaData.
boolean supportsRefCursors()	Возвращает значение, определяющее, поддерживает ли эта база данных REF CURSOR.	Возвращает значение false, если SQL Server не поддерживает REF CURSOR. Дополнительные сведения см. на странице о java.sql.DatabaseMetaData.

SQLServerResultSet, класс

Новые методы	Описание	Значимые реализации
	Обновляет указанный столбец значением объекта. Существует четыре новых метода (перегруженных) для поддержки нового интерфейса SQLType.	Реализовано, как описано в интерфейсе java.sql.ResultSet. Дополнительные сведения см. на странице о java.sql.ResultSet.

Спецификация Java Database Connectivity API 4.2 поддерживается драйвером Microsoft JDBC Driver 4.2 для SQL Server со следующими сопоставлениями типов данных.

Новые сопоставления типов данных	Описание
Новые классы в Java 8: LocalDate/LocalTime/LocalDateTime OffsetTime/OffsetDateTime Новые типы JDBC: TIME_WITH_TIMEZONE TIMESTAMP_WITH_TIMEZONE REF_CURSOR	REF_CURSOR не поддерживается в SQL Server. Драйвер вызывает исключение SQLFeatureNotSupportedException, если используется этот тип. Драйвер поддерживает все остальные новые сопоставления типов Java и JDBC в соответствии со спецификацией JDBC 4.2.