@@ -22,24 +22,15 @@ databases in Java.
2222:::{rubric} Driver options
2323:::
2424
25- :::{div}
26- You have two JDBC driver options: The {ref}` postgresql-jdbc ` Driver
27- and the {ref}` cratedb-jdbc ` Driver.
28- PostgreSQL JDBC uses the ` jdbc:postgresql:// ` protocol identifier,
29- while CrateDB JDBC uses ` jdbc:crate:// ` .
30- :::
25+ Choose one of two JDBC drivers:
26+
27+ - {ref}` postgresql-jdbc ` — ` jdbc:postgresql:// `
28+ - {ref}` cratedb-jdbc ` — ` jdbc:crate:// `
3129
32- You are encouraged to probe the PostgreSQL JDBC Driver first. This is the
33- most convenient option, specifically if the system you are connecting with
34- already includes the PostgreSQL driver JAR file, and you can't change it.
35-
36- However, applications using the PostgreSQL JDBC Driver may emit PostgreSQL-specific
37- SQL that CrateDB does not understand, while the framework assumes the
38- database would understand the PostgreSQL dialect completely.
39- In this case, use the CrateDB JDBC Driver instead
40- to ensure compatibility and allow downstream components to handle
41- CrateDB-specific behavior, for example, by employing a CrateDB-specific
42- SQL dialect implementation for their purposes and realms.
30+ Prefer the PostgreSQL JDBC driver first—it’s often already on your classpath
31+ and works out of the box. If your application or framework emits
32+ PostgreSQL‑specific SQL that CrateDB doesn’t support, switch to the CrateDB
33+ JDBC driver for full CrateDB dialect support and smoother integration.
4334
4435The {ref}` crate-jdbc:internals ` page includes more information
4536about compatibility and differences between the two driver variants,
0 commit comments