Skip to content

Commit 0674300

Browse files
committed
fix outdated section of user guide relating to Dialects
1 parent 19da8f3 commit 0674300

File tree

1 file changed

+10
-66
lines changed

1 file changed

+10
-66
lines changed

documentation/src/main/asciidoc/userguide/chapters/jdbc/Database_Access.adoc

Lines changed: 10 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -183,7 +183,7 @@ This usage is discouraged and not discussed here.
183183
[[database-connectionprovider-isolation]]
184184
=== ConnectionProvider support for transaction isolation setting
185185

186-
All of the provided ConnectionProvider implementations, other than `DataSourceConnectionProvider`, support consistent setting of transaction isolation for all `Connections` obtained from the underlying pool.
186+
All the provided `ConnectionProvider` implementations, apart from `DataSourceConnectionProvider`, support consistent setting of transaction isolation for all `Connections` obtained from the underlying pool.
187187
The value for `hibernate.connection.isolation` can be specified in one of 3 formats:
188188

189189
* the integer value accepted at the JDBC level.
@@ -252,68 +252,12 @@ Therefore for user-provided connection, the connection is acquired right away an
252252
[[database-dialect]]
253253
=== Database Dialect
254254

255-
Although SQL is relatively standardized, each database vendor uses a subset and superset of ANSI SQL defined syntax.
256-
This is referred to as the database's dialect.
257-
Hibernate handles variations across these dialects through its `org.hibernate.dialect.Dialect` class and the various subclasses for each database vendor.
258-
259-
In most cases, Hibernate will be able to determine the proper Dialect to use by asking some questions of the JDBC Connection during bootstrap.
260-
For information on Hibernate's ability to determine the proper Dialect to use (and your ability to influence that resolution), see <<chapters/portability/Portability.adoc#portability-dialectresolver,Dialect resolution>>.
261-
262-
If for some reason it is not able to determine the proper one or you want to use a custom Dialect, you will need to set the `hibernate.dialect` setting.
263-
264-
.Provided Dialects
265-
[width="100%",cols="28%,72%",options="header",]
266-
|=======================================================================
267-
|Dialect (short name) |Remarks
268-
|Cache71 |Support for the Caché database, version 2007.1.
269-
|CockroachDB192 |Support for the CockroachDB database version 19.2.
270-
|CockroachDB201 |Support for the CockroachDB database version 20.1.
271-
|CUBRID |Support for the CUBRID database, version 8.3. May work with later versions.
272-
|DB2 |Support for the DB2 database, version 8.2.
273-
|DB297 |Support for the DB2 database, version 9.7.
274-
|DB2390 |Support for DB2 Universal Database for OS/390, also known as DB2/390.
275-
|DB2400 |Support for DB2 Universal Database for iSeries, also known as DB2/400.
276-
|DB2400V7R3 |Support for DB2 Universal Database for i, also known as DB2/400, version 7.3
277-
|DerbyTenFive |Support for the Derby database, version 10.5
278-
|DerbyTenSix |Support for the Derby database, version 10.6
279-
|DerbyTenSeven |Support for the Derby database, version 10.7
280-
|Firebird |Support for the Firebird database
281-
|FrontBase |Support for the Frontbase database
282-
|H2 |Support for the H2 database
283-
|HANACloudColumnStore |Support for the SAP HANA Cloud database column store.
284-
|HANAColumnStore |Support for the SAP HANA database column store, version 2.x. This is the recommended dialect for the SAP HANA database. May work with SAP HANA, version 1.x
285-
|HANARowStore |Support for the SAP HANA database row store, version 2.x. May work with SAP HANA, version 1.x
286-
|HSQL |Support for the HSQL (HyperSQL) database
287-
|Informix |Support for the Informix database
288-
|Ingres |Support for the Ingres database, version 9.2
289-
|Ingres9 |Support for the Ingres database, version 9.3. May work with newer versions
290-
|Ingres10 |Support for the Ingres database, version 10. May work with newer versions
291-
|Interbase |Support for the Interbase database.
292-
|JDataStore |Support for the JDataStore database
293-
|McKoi |Support for the McKoi database
294-
|Mimer |Support for the Mimer database, version 9.2.1. May work with newer versions
295-
|MySQL5 |Support for the MySQL database, version 5.x
296-
|MySQL5InnoDB |Support for the MySQL database, version 5.x preferring the InnoDB storage engine when exporting tables.
297-
|MySQL57InnoDB |Support for the MySQL database, version 5.7 preferring the InnoDB storage engine when exporting tables. May work with newer versions
298-
|MariaDB |Support for the MariaDB database. May work with newer versions
299-
|MariaDB53 |Support for the MariaDB database, version 5.3 and newer.
300-
|Oracle8i |Support for the Oracle database, version 8i
301-
|Oracle9i |Support for the Oracle database, version 9i
302-
|Oracle10g |Support for the Oracle database, version 10g
303-
|Pointbase |Support for the Pointbase database
304-
|PostgresPlus |Support for the Postgres Plus database
305-
|PostgreSQL81 |Support for the PostgrSQL database, version 8.1
306-
|PostgreSQL82 |Support for the PostgreSQL database, version 8.2
307-
|PostgreSQL9 |Support for the PostgreSQL database, version 9. May work with later versions.
308-
|Progress |Support for the Progress database, version 9.1C. May work with newer versions.
309-
|SAPDB |Support for the SAPDB/MAXDB database.
310-
|SQLServer |Support for the SQL Server 2000 database
311-
|SQLServer2005 |Support for the SQL Server 2005 database
312-
|SQLServer2008 |Support for the SQL Server 2008 database
313-
|Sybase11 |Support for the Sybase database, up to version 11.9.2
314-
|SybaseAnywhere |Support for the Sybase Anywhere database
315-
|SybaseASE15 |Support for the Sybase Adaptive Server Enterprise database, version 15
316-
|SybaseASE157 |Support for the Sybase Adaptive Server Enterprise database, version 15.7. May work with newer versions.
317-
|Teradata |Support for the Teradata database
318-
|TimesTen |Support for the TimesTen database, version 5.1. May work with newer versions
319-
|=======================================================================
255+
Although SQL is now relatively standardized&mdash;much more so than in the past&mdash;it's still the case that each database vendor implements a different dialect of SQL that, while overlapping significantly with ANSI SQL, forms neither a subset, nor a superset, of the standard.
256+
257+
Hibernate abstracts over variations between dialects of SQL via the class `org.hibernate.dialect.Dialect`.
258+
259+
- There's a subclass of `Dialect` for each supported relational database in the package `org.hibernate.dialect`.
260+
- Additional community-supported ``Dialect``s are available in the separate module `hibernate-community-dialects`.
261+
262+
In Hibernate 6, it's no longer necessary to explicitly specify a dialect using the configuration property `hibernate.dialect`, and so setting that property is now discouraged.
263+
(An exception is the case of custom user-written ``Dialect``s.)

0 commit comments

Comments
 (0)