Skip to content

Commit 9470483

Browse files
committed
Connect/Java: Concise driver recommendations as suggested by CodeRabbit
1 parent 5e4c848 commit 9470483

File tree

1 file changed

+8
-17
lines changed

1 file changed

+8
-17
lines changed

docs/connect/java/index.md

Lines changed: 8 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -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

4435
The {ref}`crate-jdbc:internals` page includes more information
4536
about compatibility and differences between the two driver variants,

0 commit comments

Comments
 (0)