Skip to content

Commit 9fecfbe

Browse files
committed
#629 Some release notes refinement
1 parent af7cbd5 commit 9fecfbe

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

src/docs/asciidoc/release_notes.adoc

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -896,7 +896,7 @@ For more information, see also https://github.com/FirebirdSQL/jaybird/blob/maste
896896
[#create-database-if-not-exist]
897897
=== Connection property `createDatabaseIfNotExist`
898898

899-
The connection property `createDatabaseIfNotExist` is a Boolean property to instruct Jaybird to attempt to create the database if it does not exist yet.
899+
The Boolean connection property `createDatabaseIfNotExist` instructs Jaybird to attempt to create the database if it does not exist yet.
900900
This property can be used in the JDBC URL, in the `Properties` object passed to `DriverManager`, and can be set on data sources.
901901

902902
Although Jaybird already allowed you to create databases using `org.firebirdsql.management.FBManager`, this is not always accessible, for example in tools or libraries that only expose or use the JDBC API.
@@ -920,6 +920,14 @@ try (Connection connection = DriverManager.getConnection(
920920

921921
If the database already exists, the connection will be made with user `normaluser`, but if the database does not exist, the database will be created with user `sysdba`.
922922

923+
[IMPORTANT]
924+
====
925+
The errors Firebird returns do not make it possible to determine definitively if the database does not exist, or if there is another reason that the connection failed.
926+
Jaybird applies some simple rules to exclude some classes of errors, and not attempt to create a database in those cases.
927+
928+
If you find cases where you think Jaybird should not (or on the contrary should) attempt to create a database, please report them on https://github.com/FirebirdSQL/jaybird/issues[^].
929+
====
930+
923931
For more information, see also https://github.com/FirebirdSQL/jaybird/blob/master/devdoc/jdp/jdp-2024-02-create-database-through-jdbc-url.adoc[jdp-2024-02: Create database through JDBC URL^].
924932

925933
// TODO add major changes

0 commit comments

Comments
 (0)