Package org.hibernate.cfg

Interface JdbcSettings

All Superinterfaces:

AgroalSettings, C3p0Settings, HikariCPSettings

All Known Subinterfaces:

AvailableSettings

All Known Implementing Classes:

Environment

public interface JdbcSettings
extends C3p0Settings, AgroalSettings, HikariCPSettings

Settings related to JDBC, Connections, pools, Dialects, etc

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ALLOW_METADATA_ON_BOOT	Whether access to JDBC metadata is allowed during bootstrap.
static final String	AUTOCOMMIT	Controls the autocommit mode of JDBC connections obtained from any ConnectionProvider implementation which respects this setting, including every built-in implementation except for DatasourceConnectionProviderImpl.
static final String	CONNECTION_HANDLING	Specifies how Hibernate should manage JDBC connections in terms of acquisition and release, either: an instance of the enumeration PhysicalConnectionHandlingMode, or the name of one of its instances.
static final String	CONNECTION_PREFIX	Deprecated. This setting is only supported by C3P0ConnectionProvider and DriverManagerConnectionProviderImpl.
static final String	CONNECTION_PROVIDER	Specifies a ConnectionProvider to use for obtaining JDBC connections, either: a short strategy name like agroal, hikaricp, c3p0, an instance of ConnectionProvider, a Class object representing a class that implements ConnectionProvider, or the name of a class that implements ConnectionProvider.
static final String	CONNECTION_PROVIDER_DISABLES_AUTOCOMMIT	Indicates that connections obtained from the configured ConnectionProvider have auto-commit already disabled when they are acquired.
static final String	DATASOURCE	Deprecated. The JPA-standard "jakarta.persistence.jtaDataSource" or "jakarta.persistence.nonJtaDataSource" setting are now preferred.
static final String	DIALECT	Specifies the Hibernate SQL dialect, either an instance of Dialect, a Class representing a class that extends Dialect, or the name of a class that extends Dialect.
static final String	DIALECT_DB_MAJOR_VERSION	Deprecated. Use JAKARTA_HBM2DDL_DB_MAJOR_VERSION instead
static final String	DIALECT_DB_MINOR_VERSION	Deprecated. Use JAKARTA_HBM2DDL_DB_MINOR_VERSION instead
static final String	DIALECT_DB_NAME	Deprecated. Use JAKARTA_HBM2DDL_DB_NAME instead
static final String	DIALECT_DB_VERSION	Deprecated. Use JAKARTA_HBM2DDL_DB_VERSION instead
static final String	DIALECT_NATIVE_PARAM_MARKERS	Controls whether to use JDBC markers (`?`) or dialect native markers for parameters within preparable SQL statements.
static final String	DIALECT_RESOLVERS	Specifies additional DialectResolver implementations to register with the standard DialectFactory.
static final String	DRIVER	Deprecated. The JPA-standard setting JAKARTA_JDBC_DRIVER is now preferred.
static final String	FORMAT_SQL	Enables formatting of SQL logged to the console.
static final String	HBM2DDL_CONNECTION	Deprecated. Use JAKARTA_HBM2DDL_CONNECTION instead
static final String	HIGHLIGHT_SQL	Enables highlighting of SQL logged to the console using ANSI escape codes.
static final String	ISOLATION	Specifies the JDBC transaction isolation level for connections obtained from any ConnectionProvider implementation which respects this setting, including every built-in implementation except for DatasourceConnectionProviderImpl.
static final String	JAKARTA_HBM2DDL_CONNECTION	Allows passing a specific Connection instance to be used by SchemaManagementTool for the purpose of determining the Dialect, and for performing database actions if requested.
static final String	JAKARTA_HBM2DDL_DB_MAJOR_VERSION	Used in conjunction with "jakarta.persistence.database-product-name" for the purpose of determining the Dialect to use when the name does not provide enough detail.
static final String	JAKARTA_HBM2DDL_DB_MINOR_VERSION	Used in conjunction with "jakarta.persistence.database-product-name" for the purpose of determining the Dialect to use when the name does not provide enough detail.
static final String	JAKARTA_HBM2DDL_DB_NAME	Specifies the name of the database vendor (as would be reported by DatabaseMetaData.getDatabaseProductName()) for the purpose of determining the Dialect to use.
static final String	JAKARTA_HBM2DDL_DB_VERSION	Used in conjunction with "jakarta.persistence.database-product-name" for the purpose of determining the Dialect to use when the name does not provide enough detail.
static final String	JAKARTA_JDBC_DRIVER	Specifies the name of a JDBC driver to use to connect to the database.
static final String	JAKARTA_JDBC_PASSWORD	Specifies the password to use when connecting via JDBC.
static final String	JAKARTA_JDBC_URL	Specifies the JDBC connection URL to use to connect to the database.
static final String	JAKARTA_JDBC_USER	Specifies the database user to use when connecting via JDBC.
static final String	JAKARTA_JTA_DATASOURCE	Specifies a JTA DataSource to use for Connections.
static final String	JAKARTA_NON_JTA_DATASOURCE	Specifies a non-JTA DataSource to use for Connections.
static final String	JDBC_TIME_ZONE	Specifies the time zone to use in the JDBC driver, which is supposed to match the database timezone.
static final String	JPA_JDBC_DRIVER	Deprecated. Use JAKARTA_JDBC_DRIVER instead
static final String	JPA_JDBC_PASSWORD	Deprecated. Use JAKARTA_JDBC_PASSWORD instead
static final String	JPA_JDBC_URL	Deprecated. Use JAKARTA_JDBC_URL instead
static final String	JPA_JDBC_USER	Deprecated. Use JAKARTA_JDBC_USER instead
static final String	JPA_JTA_DATASOURCE	Deprecated. Use JAKARTA_JTA_DATASOURCE instead
static final String	JPA_NON_JTA_DATASOURCE	Deprecated. Use JAKARTA_NON_JTA_DATASOURCE instead
static final String	LOG_JDBC_ERRORS	When enabled, specifies that JDBC errors should be logged before being rethrown.
static final String	LOG_JDBC_WARNINGS	When enabled, specifies that JDBC statement warnings should be logged.
static final String	LOG_SLOW_QUERY	Specifies a duration in milliseconds defining the minimum query execution time that characterizes a "slow" query.
static final String	NON_CONTEXTUAL_LOB_CREATION	When enabled, specifies that Hibernate should not use contextual LOB creation.
static final String	PASS	Deprecated. The JPA-standard setting JAKARTA_JDBC_PASSWORD is now preferred.
static final String	POOL_SIZE	Specifies the maximum number of inactive connections for any connection pool which respects this setting, including every built-in implementation except for DatasourceConnectionProviderImpl.
static final String	SHOW_SQL	Enables logging of generated SQL to the console.
static final String	STATEMENT_FETCH_SIZE	Gives the JDBC driver a hint as to the number of rows that should be fetched from the database when more rows are needed.
static final String	STATEMENT_INSPECTOR	Specifies a StatementInspector implementation associated with the SessionFactory, either: an instance of StatementInspector, a Class representing an class that implements StatementInspector, or the name of a class that implements StatementInspector.
static final String	URL	Deprecated. The JPA-standard setting JAKARTA_JDBC_URL is now preferred.
static final String	USE_GET_GENERATED_KEYS	Specifies that generated primary keys may be retrieved using the JDBC 3 Statement.getGeneratedKeys() operation.
static final String	USE_SCROLLABLE_RESULTSET	Deprecated, for removal: This API element is subject to removal in a future version. It's not necessary to set this explicitly
static final String	USE_SQL_COMMENTS	Specifies that comments should be added to the generated SQL.
static final String	USER	Deprecated. The JPA-standard setting JAKARTA_JDBC_USER is now preferred.

Fields inherited from interface org.hibernate.cfg.AgroalSettings

AGROAL_ACQUISITION_TIMEOUT, AGROAL_CONFIG_PREFIX, AGROAL_FLUSH_ON_CLOSE, AGROAL_IDLE_TIMEOUT, AGROAL_IDLE_VALIDATION_TIMEOUT, AGROAL_INITIAL_SIZE, AGROAL_INITIAL_SQL, AGROAL_LEAK_TIMEOUT, AGROAL_MAX_LIFETIME, AGROAL_MAX_SIZE, AGROAL_MIN_SIZE, AGROAL_VALIDATE_ON_BORROW, AGROAL_VALIDATION_TIMEOUT

Fields inherited from interface org.hibernate.cfg.C3p0Settings

C3P0_ACQUIRE_INCREMENT, C3P0_CONFIG_PREFIX, C3P0_IDLE_TEST_PERIOD, C3P0_MAX_SIZE, C3P0_MAX_STATEMENTS, C3P0_MIN_SIZE, C3P0_TIMEOUT

Fields inherited from interface org.hibernate.cfg.HikariCPSettings

HIKARI_ACQUISITION_TIMEOUT, HIKARI_CONFIG_PREFIX, HIKARI_IDLE_TIMEOUT, HIKARI_INITIAL_SQL, HIKARI_INITIALIZATION_TIMEOUT, HIKARI_ISOLATE_INTERNAL_QUERIES, HIKARI_KEEPALIVE_TIME, HIKARI_LEAK_TIMEOUT, HIKARI_MAX_LIFETIME, HIKARI_MAX_SIZE, HIKARI_MIN_IDLE_SIZE, HIKARI_POOL_NAME, HIKARI_READ_ONLY, HIKARI_VALIDATION_TIMEOUT

Field Details

JAKARTA_JTA_DATASOURCE

static final String JAKARTA_JTA_DATASOURCE

Specifies a JTA DataSource to use for Connections. Hibernate allows either

• an instance of DataSource
• a JNDI name under which to obtain the DataSource; see also EnvironmentSettings.JNDI_URL, EnvironmentSettings.JNDI_CLASS, EnvironmentSettings.JNDI_PREFIX

See JPA 2 sections 9.4.3 and 8.2.1.5

See Also:

• Constant Field Values

JAKARTA_NON_JTA_DATASOURCE

static final String JAKARTA_NON_JTA_DATASOURCE

Specifies a non-JTA DataSource to use for Connections. Hibernate allows either

• an instance of DataSource
• a JNDI name under which to obtain the DataSource; see also EnvironmentSettings.JNDI_URL, EnvironmentSettings.JNDI_CLASS, EnvironmentSettings.JNDI_PREFIX

See JPA 2 sections 9.4.3 and 8.2.1.5

See Also:

• Constant Field Values

JAKARTA_JDBC_DRIVER

static final String JAKARTA_JDBC_DRIVER

Specifies the name of a JDBC driver to use to connect to the database.

Used in conjunction with JAKARTA_JDBC_URL, JAKARTA_JDBC_USER and JAKARTA_JDBC_PASSWORD to specify how to connect to the database.

When connections are obtained from a DataSource, use either JAKARTA_JTA_DATASOURCE or JAKARTA_NON_JTA_DATASOURCE instead.

See section 8.2.1.9

See Also:

• Constant Field Values

JAKARTA_JDBC_URL

static final String JAKARTA_JDBC_URL

Specifies the JDBC connection URL to use to connect to the database.

Used in conjunction with JAKARTA_JDBC_DRIVER, JAKARTA_JDBC_USER and JAKARTA_JDBC_PASSWORD to specify how to connect to the database.

When connections are obtained from a DataSource, use either JAKARTA_JTA_DATASOURCE or JAKARTA_NON_JTA_DATASOURCE instead.

See section 8.2.1.9

See Also:

• Constant Field Values

JAKARTA_JDBC_USER

static final String JAKARTA_JDBC_USER

Specifies the database user to use when connecting via JDBC.

Used in conjunction with JAKARTA_JDBC_DRIVER, JAKARTA_JDBC_URL and JAKARTA_JDBC_PASSWORD to specify how to connect to the database.

Depending on the configured ConnectionProvider, the specified username might be used to:

• create a JDBC connection using DriverManager.getConnection(String,java.util.Properties) or Driver.connect(String,java.util.Properties), or
• obtain a JDBC connection from a datasource, using DataSource.getConnection(String, String).

See section 8.2.1.9

See Also:

• DriverManager.getConnection(String, String, String)
• DataSource.getConnection(String, String)
• Constant Field Values

JAKARTA_JDBC_PASSWORD

static final String JAKARTA_JDBC_PASSWORD

Specifies the password to use when connecting via JDBC.

Used in conjunction with JAKARTA_JDBC_DRIVER, JAKARTA_JDBC_URL and JAKARTA_JDBC_USER to specify how to connect to the database.

See JPA 2 section 8.2.1.9

See Also:

• DriverManager.getConnection(String, String, String)
• DataSource.getConnection(String, String)
• Constant Field Values

JAKARTA_HBM2DDL_CONNECTION

static final String JAKARTA_HBM2DDL_CONNECTION

Allows passing a specific Connection instance to be used by SchemaManagementTool for the purpose of determining the Dialect, and for performing database actions if requested.

For Dialect resolution, "jakarta.persistence.database-product-name" and, optionally, "jakarta.persistence.database-product-version", "jakarta.persistence.database-major-version", and "jakarta.persistence.database-minor-version" can be used instead

See Also:

• JAKARTA_HBM2DDL_DB_NAME
• JAKARTA_HBM2DDL_DB_VERSION
• JAKARTA_HBM2DDL_DB_MAJOR_VERSION
• JAKARTA_HBM2DDL_DB_MINOR_VERSION
• Constant Field Values

JAKARTA_HBM2DDL_DB_NAME

static final String JAKARTA_HBM2DDL_DB_NAME

Specifies the name of the database vendor (as would be reported by DatabaseMetaData.getDatabaseProductName()) for the purpose of determining the Dialect to use.

For cases when the name of the database vendor is not enough alone, a combination of "jakarta.persistence.database-product-version", "jakarta.persistence.database-major-version" "jakarta.persistence.database-minor-version" can be used instead

See Also:

• JAKARTA_HBM2DDL_DB_VERSION
• JAKARTA_HBM2DDL_DB_MAJOR_VERSION
• JAKARTA_HBM2DDL_DB_MINOR_VERSION
• Constant Field Values

Implementation Specification:

database actions are not available when supplying just the name and versions

JAKARTA_HBM2DDL_DB_VERSION

static final String JAKARTA_HBM2DDL_DB_VERSION

Used in conjunction with "jakarta.persistence.database-product-name" for the purpose of determining the Dialect to use when the name does not provide enough detail.

The value is expected to match what would be returned from DatabaseMetaData.getDatabaseProductVersion()) for the underlying database.

See Also:

• JAKARTA_HBM2DDL_DB_NAME
• Constant Field Values

JAKARTA_HBM2DDL_DB_MAJOR_VERSION

static final String JAKARTA_HBM2DDL_DB_MAJOR_VERSION

Used in conjunction with "jakarta.persistence.database-product-name" for the purpose of determining the Dialect to use when the name does not provide enough detail.

The value is expected to match what would be returned from DatabaseMetaData.getDatabaseMajorVersion()) for the underlying database.

See Also:

• JAKARTA_HBM2DDL_DB_NAME
• Constant Field Values

JAKARTA_HBM2DDL_DB_MINOR_VERSION

static final String JAKARTA_HBM2DDL_DB_MINOR_VERSION

Used in conjunction with "jakarta.persistence.database-product-name" for the purpose of determining the Dialect to use when the name does not provide enough detail.

The value is expected to match what would be returned from DatabaseMetaData.getDatabaseMinorVersion()) for the underlying database.

See Also:

• JAKARTA_HBM2DDL_DB_NAME
• Constant Field Values

DIALECT

static final String DIALECT

Specifies the Hibernate SQL dialect, either

• an instance of Dialect,
• a Class representing a class that extends Dialect, or
• the name of a class that extends Dialect.

By default, Hibernate will attempt to automatically determine the dialect from the JDBC URL and JDBC metadata, so this setting is not usually necessary.

See Also:

• Dialect
• Constant Field Values

API Note:

As of Hibernate 6, this property should not be explicitly specified, except when using a custom user-written implementation of Dialect. Instead, applications should allow Hibernate to select the Dialect automatically.

DIALECT_RESOLVERS

static final String DIALECT_RESOLVERS

Specifies additional DialectResolver implementations to register with the standard DialectFactory.

See Also:

• Constant Field Values

CONNECTION_PROVIDER

static final String CONNECTION_PROVIDER

Specifies a ConnectionProvider to use for obtaining JDBC connections, either:

• a short strategy name like agroal, hikaricp, c3p0,
• an instance of ConnectionProvider,
• a Class object representing a class that implements ConnectionProvider, or
• the name of a class that implements ConnectionProvider.

If this property is not explicitly set, a connection provider is chosen automatically:

• if JAKARTA_JTA_DATASOURCE or JAKARTA_NON_JTA_DATASOURCE is set, a datasource-based implementation is used;
• otherwise, a ConnectionProvider is loaded automatically as a Java service;
• but if no service is found, or if more than one service is available, a default implementation is used as a fallback.

The default implementation is not recommended for use in production.

See Also:

• Constant Field Values

API Note:

The term "class" appears in the setting name due to legacy reasons; however it can accept instances.

POOL_SIZE

static final String POOL_SIZE

Specifies the maximum number of inactive connections for any connection pool which respects this setting, including every built-in implementation except for DatasourceConnectionProviderImpl.

The default pool size depends on the connection provider.

See Also:

• Constant Field Values

ISOLATION

static final String ISOLATION

Specifies the JDBC transaction isolation level for connections obtained from any ConnectionProvider implementation which respects this setting, including every built-in implementation except for DatasourceConnectionProviderImpl.

Possible values are enumerated by Connection: READ_UNCOMMITTED, READ_COMMITTED, REPEATABLE_READ, SERIALIZABLE.

If this setting is not explicitly specified, Hibernate does not modify the transaction isolation level of the JDBC connection.

See Also:

• Connection.setTransactionIsolation(int)
• Constant Field Values

AUTOCOMMIT

static final String AUTOCOMMIT

Controls the autocommit mode of JDBC connections obtained from any ConnectionProvider implementation which respects this setting, including every built-in implementation except for DatasourceConnectionProviderImpl.

See Also:

• Connection.setAutoCommit(boolean)
• Constant Field Values

Default Value:

false

CONNECTION_PROVIDER_DISABLES_AUTOCOMMIT

static final String CONNECTION_PROVIDER_DISABLES_AUTOCOMMIT

Indicates that connections obtained from the configured ConnectionProvider have auto-commit already disabled when they are acquired.

It is inappropriate to set this value to true when the connections returned by the provider do not, in fact, have auto-commit disabled. Doing so may lead to Hibernate executing SQL operations outside the scope of any transaction.

Since:

5.2.10

See Also:

• SessionFactoryBuilder.applyConnectionProviderDisablesAutoCommit(boolean)
• Constant Field Values

API Note:

By default, Hibernate calls Connection.setAutoCommit(boolean) on newly-obtained connections. With this setting enabled, that call is skipped, along with some other operations, in the interest of performance.

Default Value:

false

CONNECTION_PREFIX

@Deprecated(since="7")
static final String CONNECTION_PREFIX

Deprecated.

This setting is only supported by C3P0ConnectionProvider and DriverManagerConnectionProviderImpl.

A prefix for properties specifying arbitrary JDBC connection properties. These properties are simply passed along to the provider when creating a connection.

For example, declaring hibernate.connection.foo=bar tells Hibernate to append foo=bar to the JDBC connection URL.

See Also:

• Constant Field Values

STATEMENT_INSPECTOR

static final String STATEMENT_INSPECTOR

Specifies a StatementInspector implementation associated with the SessionFactory, either:

• an instance of StatementInspector,
• a Class representing an class that implements StatementInspector, or
• the name of a class that implements StatementInspector.

Since:

5.0

See Also:

• SessionFactoryBuilder.applyStatementInspector(StatementInspector)
• Constant Field Values

SHOW_SQL

static final String SHOW_SQL

Enables logging of generated SQL to the console.

See Also:

• Constant Field Values

Default Value:

false

FORMAT_SQL

static final String FORMAT_SQL

Enables formatting of SQL logged to the console.

See Also:

• Constant Field Values

Default Value:

false

HIGHLIGHT_SQL

static final String HIGHLIGHT_SQL

Enables highlighting of SQL logged to the console using ANSI escape codes.

See Also:

• Constant Field Values

Default Value:

false

LOG_SLOW_QUERY

static final String LOG_SLOW_QUERY

Specifies a duration in milliseconds defining the minimum query execution time that characterizes a "slow" query. Any SQL query which takes longer than this amount of time to execute will be logged.

A value of 0, the default, disables logging of "slow" queries.

See Also:

• Statistics.getSlowQueries()
• Constant Field Values

USE_SQL_COMMENTS

static final String USE_SQL_COMMENTS

Specifies that comments should be added to the generated SQL.

See Also:

• SessionFactoryBuilder.applySqlComments(boolean)
• Constant Field Values

Default Value:

false

STATEMENT_FETCH_SIZE

static final String STATEMENT_FETCH_SIZE

Gives the JDBC driver a hint as to the number of rows that should be fetched from the database when more rows are needed. If 0, the JDBC driver's default settings will be used.

See Also:

• Statement.setFetchSize(int)
• SessionFactoryBuilder.applyJdbcFetchSize(int)
• ScrollableResults.setFetchSize(int)
• Constant Field Values

Default Value:

0

USE_SCROLLABLE_RESULTSET

@Deprecated(since="7",
            forRemoval=true)
static final String USE_SCROLLABLE_RESULTSET

Deprecated, for removal: This API element is subject to removal in a future version.

It's not necessary to set this explicitly

Controls how Hibernate should handle scrollable results:

• true indicates that insensitive scrolling can be used;
• false indicates that forward-only scrolling must be used.

See Also:

• SessionFactoryBuilder.applyScrollableResultsSupport(boolean)
• Query.scroll()
• ExtractedDatabaseMetaData.supportsScrollableResults()
• Constant Field Values

Default Value:

true if the underlying driver supports scrollable results, false otherwise

DIALECT_NATIVE_PARAM_MARKERS

@Incubating
static final String DIALECT_NATIVE_PARAM_MARKERS

Controls whether to use JDBC markers (`?`) or dialect native markers for parameters within preparable SQL statements.

Since:

6.2

See Also:

• ParameterMarkerStrategy
• Dialect.getNativeParameterMarkerStrategy()
• Constant Field Values

Implementation Note:

False by default, indicating standard JDBC parameter markers (`?`) are used. Set to true to use the Dialect's native markers, if any. For Dialects without native markers, the standard JDBC strategy is used.

NON_CONTEXTUAL_LOB_CREATION

static final String NON_CONTEXTUAL_LOB_CREATION

When enabled, specifies that Hibernate should not use contextual LOB creation.

See Also:

• LobCreator
• LobCreationContext
• Constant Field Values

LOG_JDBC_WARNINGS

static final String LOG_JDBC_WARNINGS

When enabled, specifies that JDBC statement warnings should be logged.

Logging of JDBC warnings may also be controlled via the log category "org.hibernate.orm.jdbc.warn".

The default is determined by Dialect.isJdbcLogWarningsEnabledByDefault().

Since:

5.1

See Also:

• Statement.getWarnings()
• Constant Field Values

LOG_JDBC_ERRORS

@Incubating
static final String LOG_JDBC_ERRORS

When enabled, specifies that JDBC errors should be logged before being rethrown.

Logging of JDBC errors may also be controlled via the log category "org.hibernate.orm.jdbc.error".

Since:

7

See Also:

• Constant Field Values

Default Value:

true

JDBC_TIME_ZONE

static final String JDBC_TIME_ZONE

Specifies the time zone to use in the JDBC driver, which is supposed to match the database timezone.

This is the timezone what will be passed to PreparedStatement.setTimestamp(int, java.sql.Timestamp, java.util.Calendar) PreparedStatement.setTime(int, java.sql.Time, java.util.Calendar), ResultSet.getTimestamp(int, Calendar), and ResultSet.getTime(int, Calendar) when binding parameters.

The time zone may be given as:

• an instance of TimeZone,
• an instance of ZoneId, or
• a time zone ID string to be passed to ZoneId.of(String).

By default, the JVM default time zone is assumed by the JDBC driver.

Since:

5.2.3

See Also:

• Constant Field Values

USE_GET_GENERATED_KEYS

static final String USE_GET_GENERATED_KEYS

Specifies that generated primary keys may be retrieved using the JDBC 3 Statement.getGeneratedKeys() operation.

Usually, performance will be improved if this behavior is enabled, assuming the JDBC driver supports getGeneratedKeys().

See Also:

• Statement.getGeneratedKeys()
• SessionFactoryBuilder.applyGetGeneratedKeysSupport(boolean)
• Constant Field Values

Default Value:

true if the underlying driver supports getGeneratedKeys(), false otherwise

CONNECTION_HANDLING

static final String CONNECTION_HANDLING

Specifies how Hibernate should manage JDBC connections in terms of acquisition and release, either:

• an instance of the enumeration PhysicalConnectionHandlingMode, or
• the name of one of its instances.

The default is DELAYED_ACQUISITION_AND_RELEASE_AFTER_TRANSACTION.

Since:

5.2

See Also:

• PhysicalConnectionHandlingMode
• SessionFactoryBuilder.applyConnectionHandlingMode(PhysicalConnectionHandlingMode)
• Constant Field Values

ALLOW_METADATA_ON_BOOT

static final String ALLOW_METADATA_ON_BOOT

Whether access to JDBC metadata is allowed during bootstrap.

Typically, Hibernate accesses this metadata to understand the capabilities of the underlying database to help minimize needed configuration. Disabling this access means that only explicit settings are used. At a minimum, the Dialect to use must be specified using either the "hibernate.dialect" or "jakarta.persistence.database-product-name" setting. When the Dialect to use is specified in this manner it is generally a good idea to specify the database version as well - Dialects use the version to configure themselves.

Since:

6.5

See Also:

• Constant Field Values

API Note:

The specified Dialect may also provide defaults into the "explicit" settings.

Default Value:

true

DRIVER

@Deprecated
static final String DRIVER

Deprecated.

The JPA-standard setting JAKARTA_JDBC_DRIVER is now preferred.

See Also:

• Constant Field Values

URL

@Deprecated
static final String URL

Deprecated.

The JPA-standard setting JAKARTA_JDBC_URL is now preferred.

See Also:

• Constant Field Values

USER

@Deprecated
static final String USER

Deprecated.

The JPA-standard setting JAKARTA_JDBC_USER is now preferred.

See Also:

• PASS
• Constant Field Values

PASS

@Deprecated
static final String PASS

Deprecated.

The JPA-standard setting JAKARTA_JDBC_PASSWORD is now preferred.

See Also:

• USER
• Constant Field Values

DATASOURCE

@Deprecated
static final String DATASOURCE

Deprecated.

The JPA-standard "jakarta.persistence.jtaDataSource" or "jakarta.persistence.nonJtaDataSource" setting are now preferred.

See Also:

• DataSource
• Constant Field Values

JPA_JTA_DATASOURCE

@Deprecated
static final String JPA_JTA_DATASOURCE

Deprecated.

Use JAKARTA_JTA_DATASOURCE instead

See Also:

• Constant Field Values

JPA_NON_JTA_DATASOURCE

@Deprecated
static final String JPA_NON_JTA_DATASOURCE

Deprecated.

Use JAKARTA_NON_JTA_DATASOURCE instead

See Also:

• Constant Field Values

JPA_JDBC_DRIVER

@Deprecated
static final String JPA_JDBC_DRIVER

Deprecated.

Use JAKARTA_JDBC_DRIVER instead

See Also:

• Constant Field Values

JPA_JDBC_URL

@Deprecated
static final String JPA_JDBC_URL

Deprecated.

Use JAKARTA_JDBC_URL instead

See Also:

• Constant Field Values

JPA_JDBC_USER

@Deprecated
static final String JPA_JDBC_USER

Deprecated.

Use JAKARTA_JDBC_USER instead

See Also:

• Constant Field Values

JPA_JDBC_PASSWORD

@Deprecated
static final String JPA_JDBC_PASSWORD

Deprecated.

Use JAKARTA_JDBC_PASSWORD instead

See Also:

• Constant Field Values

HBM2DDL_CONNECTION

@Deprecated
static final String HBM2DDL_CONNECTION

Deprecated.

Use JAKARTA_HBM2DDL_CONNECTION instead

See Also:

• Constant Field Values

DIALECT_DB_NAME

@Deprecated
static final String DIALECT_DB_NAME

Deprecated.

Use JAKARTA_HBM2DDL_DB_NAME instead

See Also:

• DIALECT_DB_VERSION
• DIALECT_DB_MAJOR_VERSION
• DIALECT_DB_MINOR_VERSION
• Constant Field Values

DIALECT_DB_VERSION

@Deprecated
static final String DIALECT_DB_VERSION

Deprecated.

Use JAKARTA_HBM2DDL_DB_VERSION instead

See Also:

• DIALECT_DB_NAME
• Constant Field Values

DIALECT_DB_MAJOR_VERSION

@Deprecated
static final String DIALECT_DB_MAJOR_VERSION

Deprecated.

Use JAKARTA_HBM2DDL_DB_MAJOR_VERSION instead

See Also:

• DIALECT_DB_NAME
• DIALECT_DB_MINOR_VERSION
• Constant Field Values

DIALECT_DB_MINOR_VERSION

@Deprecated
static final String DIALECT_DB_MINOR_VERSION

Deprecated.

Use JAKARTA_HBM2DDL_DB_MINOR_VERSION instead

See Also:

• DIALECT_DB_NAME
• DIALECT_DB_MAJOR_VERSION
• DialectResolver
• Constant Field Values